Compartilhar via

az image builder output

Gerenciar distribuidores de saída de modelo do construtor de imagens.

Uma imagem personalizada pode ser distribuída como uma imagem gerenciada, uma imagem compartilhada em uma SIG (galeria de imagens compartilhadas) ou como um blob VHD.

Comandos

Nome Description Tipo Status
az image builder output add

Adicione um distribuidor de saída do construtor de imagens a um modelo do construtor de imagens.

 Core GA
az image builder output clear

Remova todos os distribuidores de saída do construtor de imagens de um modelo de construtor de imagens.

 Core GA
az image builder output remove

Remova um distribuidor de saída do construtor de imagens de um modelo de construtor de imagens.

 Core GA
az image builder output versioning

Gerenciar o controle de versão de saída do modelo do construtor de imagens.

 Core GA
az image builder output versioning remove

Remova todas as opções de controle de versão em saídas especificadas.

 Core GA
az image builder output versioning set

Defina o controle de versão de saída do construtor de imagens de um modelo de construtor de imagens.

 Core GA
az image builder output versioning show

Mostrar opções de controle de versão em saídas especificadas.

 Core GA

az image builder output add

Adicione um distribuidor de saída do construtor de imagens a um modelo do construtor de imagens.

Deve ser usado com --defer. O distribuidor de saída pode ser uma imagem gerenciada, uma imagem da galeria ou um blob VHD.

az image builder output add [--artifact-tags]
                            [--defer]
                            [--gallery-image-definition]
                            [--gallery-name]
                            [--gallery-replication-regions]
                            [--ids]
                            [--is-vhd]
                            [--managed-image]
                            [--managed-image-location]
                            [--name]
                            [--output-name]
                            [--resource-group]
                            [--subscription]
                            [--versioning {Latest, Source}]
                            [--vhd-uri]

Exemplos

Adicione um distribuidor de imagem gerenciada a um modelo de imagem no cache de objetos da CLI. Especifique um nome de saída de execução.

az image builder output add -n mytemplate -g my-group \
    --managed-image my_desired_image_name --output-name managed_image_run_01 --defer

Adicione um distribuidor de galeria de imagens compartilhadas a um modelo de imagem no cache de objetos da CLI. Especifique suas regiões de replicação.

az image builder output add -n mytemplate -g my-group --gallery-name my_shared_gallery \
    --gallery-replication-regions westus brazilsouth \
    --gallery-image-definition linux_image_def --defer

Adicione um distribuidor VHD a um modelo de imagem no cache de objetos da CLI.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd  --defer

Adicione um distribuidor VHD com a especificação de uri de armazenamento a um modelo de imagem no cache de objetos da CLI.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd --vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file --defer

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--artifact-tags

Marcas que serão aplicadas ao artefato de saída depois que ele tiver sido criado pelo distribuidor. marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--defer

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

--gallery-image-definition

Nome ou ID da definição de imagem SIG existente com a qual criar a versão da imagem personalizada.

Propriedade Valor
Grupo de parâmetros: Shared Image Gallery Arguments
--gallery-name

Nome da galeria de imagens compartilhadas, se o nome da definição da imagem e não a ID tiverem sido fornecidos.

Propriedade Valor
Grupo de parâmetros: Shared Image Gallery Arguments
--gallery-replication-regions

Lista separada por espaço de regiões para a qual replicar a versão da imagem. O padrão é a localização do grupo de recursos.

Propriedade Valor
Grupo de parâmetros: Shared Image Gallery Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--is-vhd

A saída é um distribuidor VHD.

Propriedade Valor
Grupo de parâmetros: VHD Arguments
--managed-image

Nome ou ID da imagem gerenciada personalizada a ser criada.

Propriedade Valor
Grupo de parâmetros: Managed Image Arguments
--managed-image-location

Local onde a imagem personalizada será criada. O padrão é a localização do grupo de recursos.

Propriedade Valor
Grupo de parâmetros: Managed Image Arguments
--name -n

O nome do modelo de imagem.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--output-name

Nome da saída de execução do construtor de imagens. O padrão é o nome da imagem gerenciada ou da definição de imagem sig.

--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--versioning

Descreva como gerar um novo número de versão x.y.z para distribuição.

Propriedade Valor
Valores aceitos: Latest, Source
--vhd-uri

URI opcional do Armazenamento do Azure para o blob de VHD distribuído. Omita usar o padrão (cadeia de caracteres vazia) nesse caso, o VHD seria publicado na conta de armazenamento no grupo de recursos de preparo.

Propriedade Valor
Grupo de parâmetros: VHD Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az image builder output clear

Remova todos os distribuidores de saída do construtor de imagens de um modelo de construtor de imagens.

Deve ser usado com --defer.

az image builder output clear [--defer]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--defer

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do modelo de imagem.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az image builder output remove

Remova um distribuidor de saída do construtor de imagens de um modelo de construtor de imagens.

Deve ser usado com --defer.

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

Parâmetros Exigidos

--output-name

Nome da saída de execução do construtor de imagens.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--defer

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

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do modelo de imagem.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False