az image builder customizer

Gerencie os personalizadores de modelo do Image Builder.

Comandos

az image builder customizer add

Adicione um personalizador do construtor de imagem a um modelo do Image Builder.

az image builder customizer clear

Remova todos os personalizadores do Image Builder de um modelo do Image Builder.

az image builder customizer remove

Remova um personalizador do Image Builder de um modelo do Image Builder.

az image builder customizer add

Adicione um personalizador do construtor de imagem a um modelo do Image Builder.

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 my-group \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shell-script-inline --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 my-group \
    --customizer-name my-file --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 da CLI

az image builder customizer add -n mytemplate -g my-group \
--customizer-name shell-script-url \
--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 my-group --customizer-name win_update --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 em que o arquivo especificado na fonte de arquivo--Source será baixado para na imagem.

--exit-codes -e

Lista separada por espaços 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 do GitHub, URI de SAS para o armazenamento do Azure, etc.

--filters

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

--ids

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

--inline-script

Lista separada por espaços 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

Reinicie o tempo limite especificado como uma cadeia de caracteres que consiste em uma magnitude e uma unidade, por exemplo, ' 5 min ' (5 minutos) ou ' segundo ' (2 horas).

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

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

--search-criteria

Critérios para Pesquisar atualizações. Omita ou especifique uma cadeia de caracteres vazia para usar o padrão (pesquisar tudo). Consulte o link acima para obter exemplos e uma descrição detalhada desse 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).

az image builder customizer clear

Remova todos os personalizadores do Image Builder de um modelo do Image Builder.

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 uma ID de recurso completa 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 .

az image builder customizer remove

Remova um personalizador do Image Builder de um modelo do Image Builder.

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 uma ID de recurso completa 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 .