az image builder customizer
Gerencie personalizadores de modelos do construtor de imagens.
Comandos
Name | Description | Tipo | Status |
---|---|---|---|
az image builder customizer add |
Adicione um personalizador de construtor de imagens a um modelo de construtor de imagens. |
Principal | GA |
az image builder customizer clear |
Remova todos os personalizadores do construtor de imagens de um modelo de construtor de imagens. |
Principal | GA |
az image builder customizer remove |
Remova um personalizador de construtor de imagens de um modelo de construtor de imagens. |
Principal | GA |
az image builder customizer add
Adicione um personalizador de construtor de imagens a um modelo de construtor de imagens.
Deve ser usado com --defer.
az image builder customizer add --customizer-name
--type {file, powershell, shell, windows-restart, windows-update}
[--defer]
[--dest-path]
[--exit-codes]
[--file-source]
[--filters]
[--ids]
[--inline-script]
[--name]
[--resource-group]
[--restart-check-command]
[--restart-command]
[--restart-timeout]
[--script-url]
[--search-criteria]
[--subscription]
[--update-limit]
Exemplos
Adicionar um personalizador de shell embutido a um modelo de imagem no cache de objetos cli
az image builder customizer add -n myTemplate -g myGroup \
--inline-script "sudo mkdir /buildArtifacts" \
"sudo cp /tmp/index.html /buildArtifacts/index.html" \
--customizer-name shellScriptInline --type shell --defer
Adicionar um personalizador de arquivos a um modelo de imagem no cache de objetos cli
az image builder customizer add -n myTemplate -g myGroup \
--customizer-name myFile --type file \
--file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer
Adicionar um personalizador de reinicialização do Windows a um modelo de imagem no cache de objetos cli
az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM > \
c:\buildArtifacts\restart.txt" \
--type windows-restart --restart-timeout 10m --defer
Adicione um personalizador de atualização do Windows a um modelo de imagem no cache de objetos da cli.
az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer
Parâmetros Obrigatórios
Nome do personalizador.
Tipo de personalizador a ser adicionado ao modelo de imagem.
Parâmetros Opcionais
Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache
comandos para visualizar/limpar.
O caminho de destino absoluto para onde o arquivo especificado em --file-source será baixado na imagem.
Lista separada por espaços de códigos de saída válidos, como inteiros.
O URI do arquivo a ser baixado na imagem. Pode ser um link github, URI SAS para Armazenamento do Azure, etc.
Filtros delimitados por espaço para selecionar atualizações a serem aplicadas. Omitir ou especificar matriz vazia para usar o padrão (sem filtro).
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
Lista separada por espaço de linhas de script embutidas para personalizar a imagem.
O nome do modelo de imagem.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Comando para verificar se a reinicialização foi bem-sucedida.
Comando para executar a operação de reinicialização.
Tempo limite de reinicialização especificado como uma cadeia de caracteres que consiste em uma magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas).
URL do script para personalizar a imagem. O URL deve ser acessível publicamente.
Critérios para pesquisar atualizações. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (pesquisar tudo). Consulte o link acima para obter exemplos e uma descrição detalhada deste campo.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Número máximo de atualizações a aplicar de cada vez. Omita ou especifique 0 para usar o padrão (1000).
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az image builder customizer clear
Remova todos os personalizadores do construtor de imagens de um modelo de construtor de imagens.
Deve ser usado com --defer.
az image builder customizer clear [--defer]
[--ids]
[--name]
[--resource-group]
[--subscription]
Parâmetros Opcionais
Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache
comandos para visualizar/limpar.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do modelo de imagem.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az image builder customizer remove
Remova um personalizador de construtor de imagens de um modelo de construtor de imagens.
Deve ser usado com --defer.
az image builder customizer remove --customizer-name
[--defer]
[--ids]
[--name]
[--resource-group]
[--subscription]
Parâmetros Obrigatórios
Nome do personalizador.
Parâmetros Opcionais
Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache
comandos para visualizar/limpar.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do modelo de imagem.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.