Compartilhar via

az image builder customizer

  • Referência

Gerenciar os personalizadores de modelo do Construtor de Imagens.

Comandos

Nome Description Tipo Status
az image builder customizer add

Adicione um personalizador de construtor de imagens a um modelo de construtor de imagens.

 Núcleo GA
az image builder customizer clear

Remova todos os personalizadores do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder customizer remove

Remova um personalizador do construtor de imagens de um modelo do construtor de imagens.

 Núcleo 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 da 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 arquivo a um modelo de imagem no cache de objetos da 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 do Windows Update 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 Exigidos

--customizer-name

Nome do personalizador.

--type -t

Tipo de personalizador a ser adicionado ao modelo de imagem.

Valores aceitos: file, powershell, shell, windows-restart, windows-update

Parâmetros Opcionais

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache comandos para exibir/limpar.

--dest-path

O caminho de destino absoluto para o qual o arquivo especificado em --file-source será baixado na imagem.

--exit-codes -e

Lista separada por espaço de códigos de saída válidos, como inteiros.

--file-source

O URI do arquivo a ser baixado na imagem. Pode ser um link github, URI SAS para Armazenamento do Azure, etc.

--filters

Filtros delimitados por espaço para selecionar as atualizações a serem aplicadas. Omita ou especifique a matriz vazia para usar o padrão (sem filtro).

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--inline-script

Lista separada por espaço de linhas de script embutidas para personalizar a imagem.

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--restart-check-command

Comando para verificar se a reinicialização foi bem-sucedida.

--restart-command

Comando para executar a operação de reinicialização.

--restart-timeout

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).

Valor padrão: 5m
--script-url

URL do script para personalizar a imagem com. A URL deve ser acessível publicamente.

--search-criteria

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 descrição detalhada deste campo.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--update-limit

Número máximo de atualizações a serem aplicadas por vez. Omita ou especifique 0 para usar o padrão (1000).

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache comandos para exibir/limpar.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az image builder customizer remove

Remova um personalizador do construtor de imagens de um modelo do construtor de imagens.

Deve ser usado com --defer.

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

Parâmetros Exigidos

--customizer-name

Nome do personalizador.

Parâmetros Opcionais

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use az cache comandos para exibir/limpar.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do modelo de imagem.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.