Compartilhar via


az sig image-definition

Nota

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencie a imagem da galeria compartilhada com a VM.

Comandos

Nome Description Tipo Status
az sig image-definition create

Crie uma definição de imagem da galeria.

Núcleo GA
az sig image-definition delete

Exclua uma imagem da galeria.

Núcleo GA
az sig image-definition list

Listar definições de imagem da galeria em uma galeria.

Núcleo GA
az sig image-definition list-community

Listar definições de imagem de VM em uma comunidade de galerias.

Núcleo GA
az sig image-definition list-community (image-gallery extensão)

Listar definições de imagem de VM em uma comunidade de galerias (versão prévia).

Extensão Experimental
az sig image-definition list-shared

Listar definições de imagem de VM em uma galeria compartilhada diretamente com sua assinatura ou locatário.

Núcleo GA
az sig image-definition show

Obtenha informações sobre uma definição de imagem da galeria.

Núcleo GA
az sig image-definition show-community

Obtenha uma imagem da galeria da comunidade.

Núcleo GA
az sig image-definition show-community (image-gallery extensão)

Obtenha uma imagem em uma comunidade de galerias (versão prévia).

Extensão Experimental
az sig image-definition show-shared

Obtenha uma imagem da galeria compartilhada.

Núcleo GA
az sig image-definition update

Atualize uma definição de imagem de VM.

Núcleo GA
az sig image-definition wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Núcleo GA

az sig image-definition create

Crie uma definição de imagem da galeria.

az sig image-definition create --gallery-image-definition
                               --gallery-name
                               --offer
                               --os-type {Linux, Windows}
                               --publisher
                               --resource-group
                               --sku
                               [--architecture {Arm64, x64}]
                               [--description]
                               [--disallowed-disk-types]
                               [--end-of-life-date]
                               [--eula]
                               [--features]
                               [--hyper-v-generation {V1, V2}]
                               [--location]
                               [--maximum-cpu-core]
                               [--maximum-memory]
                               [--minimum-cpu-core]
                               [--minimum-memory]
                               [--os-state {Generalized, Specialized}]
                               [--plan-name]
                               [--plan-product]
                               [--plan-publisher]
                               [--privacy-statement-uri]
                               [--release-note-uri]
                               [--tags]

Exemplos

Criar uma definição de imagem para imagens especializadas do Linux

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized

Criar uma definição de imagem para imagens generalizadas do Linux

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Generalized

Criar uma definição de imagem para imagens de janelas especializadas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Specialized

Criar uma definição de imagem para imagens generalizadas do Windows

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Generalized

Criar uma definição de imagem com informações de plano

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized --plan-name PlanName \
--plan-product PlanProduct --plan-publisher PlanPublisher

Criar uma definição de imagem para imagens que dão suporte ao recurso de hibernação

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsHibernateSupported=true

Criar uma definição de imagem para imagens que dão suporte à rede acelerada

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsAcceleratedNetworkSupported=true

Crie uma definição de imagem para imagens que só podem ser usadas para criar VMs confiáveis. Somente VMs confiáveis podem ser criadas a partir dessa imagem.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunch

Crie uma definição de imagem para imagens que podem ser usadas para criar VMs confidenciais.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVmSupported

Crie uma definição de imagem para imagens que só podem ser usadas para criar VMs confidenciais. Somente VMs confidenciais podem ser criadas com base nessa imagem.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVM

Crie uma definição de imagem para imagens que podem ser usadas para criar VMs Gen2 ou TrustedLaunchSupported.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchSupported

Crie uma definição de imagem para imagens que podem ser usadas para criar VMs Gen2, TrustedLaunch ou Confidencial.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchAndConfidentialVmSupported

Criar uma definição de imagem e indicar a data de fim da vida útil

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--end-of-life-date YYYY-MM-DDTHH:MM:SS+00:00

Crie uma definição de imagem e recomende CPU e memória mínima e máxima (GB)

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--minimum-cpu-core myMinCPU --maximum-cpu-core myMaxCPU \
--minimum-memory myMinMemory --maximum-memory myMaxMemory

Criar uma definição de imagem e indicar quais tipos de disco do sistema operacional não são recomendados para a imagem

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--disallowed-disk-types Standard_LRS

Criar uma definição de imagem e fornecer o URI da política de privacidade e eULA

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--eula path_to_eula --privacy-statement-uri path_to_statement \
--release-note-uri path_to_release_notes

Parâmetros Exigidos

--gallery-image-definition -i

Definição de imagem da galeria.

--gallery-name -r

Nome da galeria.

--offer -f

Oferta de imagem.

--os-type

O tipo do sistema operacional incluído no disco se estiver criando uma VM com base na imagem do usuário ou em um VHD especializado.

Valores aceitos: Linux, Windows
--publisher -p

Editor de imagens.

--resource-group -g

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

--sku -s

SKU de imagem.

Parâmetros Opcionais

--architecture

Arquitetura da CPU.

Valores aceitos: Arm64, x64
--description

A descrição da definição de imagem da galeria.

--disallowed-disk-types

Tipos de disco que não funcionariam com a imagem, por exemplo, Standard_LRS.

--end-of-life-date

A data de fim da vida útil, por exemplo, '2020-12-31'.

--eula

O contrato Eula para a imagem da galeria.

--features

Uma lista de recursos de imagem da galeria. Por exemplo, "IsSecureBootSupported=true IsMeasuredBootSupported=false".

--hyper-v-generation

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

Valores aceitos: V1, V2
Valor padrão: V2
--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--maximum-cpu-core

Núcleos máximos de cpu.

--maximum-memory

Memória máxima em MB.

--minimum-cpu-core

Núcleos mínimos de cpu.

--minimum-memory

Memória mínima em MB.

--os-state

Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob essa imagem são "Generalizadas" ou "Especializadas".

Valores aceitos: Generalized, Specialized
Valor padrão: Generalized
--plan-name

Nome do plano.

--plan-product

Planejar o produto.

--plan-publisher

Planejar o publicador.

--privacy-statement-uri

O uri da política de privacidade.

--release-note-uri

O uri da nota de versão.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition delete

Exclua uma imagem da galeria.

az sig image-definition delete [--gallery-image-definition]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--resource-group]
                               [--subscription]

Parâmetros Opcionais

--gallery-image-definition --gallery-image-name -i

O nome da definição de imagem da galeria a ser excluída.

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas na qual a Definição de Imagem deve ser excluída.

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

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition list

Listar definições de imagem da galeria em uma galeria.

az sig image-definition list --gallery-name
                             --resource-group
                             [--max-items]
                             [--next-token]

Parâmetros Exigidos

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas da qual as Definições de Imagem devem ser listadas.

--resource-group -g

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

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition list-community

Listar definições de imagem de VM em uma comunidade de galerias.

az sig image-definition list-community [--ids]
                                       [--location]
                                       [--marker]
                                       [--public-gallery-name]
                                       [--show-next-marker]
                                       [--subscription]

Exemplos

Liste uma definição de imagem em uma comunidade da galeria.

az sig image-definition list-community --public-gallery-name publicGalleryName \
--location myLocation

Parâmetros Opcionais

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retornará o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, esse gerador começará a retornar os resultados do ponto em que o gerador anterior parou.

--public-gallery-name

O nome público da galeria da comunidade.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition list-community (image-gallery extensão)

Habilitação

Esse comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar definições de imagem de VM em uma comunidade de galerias (versão prévia).

Listar definições de imagem de VM em uma comunidade de galerias (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por email sigpmdev@microsoft.com para se registrar para visualização se você estiver interessado em usar esse recurso).

az sig image-definition list-community [--ids]
                                       [--location]
                                       [--marker]
                                       [--public-gallery-name]
                                       [--show-next-marker]
                                       [--subscription]

Exemplos

Liste uma definição de imagem em uma comunidade da galeria.

az sig image-definition list-community --public-gallery-name publicGalleryName \
--location myLocation

Parâmetros Opcionais

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retornará o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, esse gerador começará a retornar os resultados do ponto em que o gerador anterior parou.

--public-gallery-name

O nome público da galeria da comunidade.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition list-shared

Listar definições de imagem de VM em uma galeria compartilhada diretamente com sua assinatura ou locatário.

az sig image-definition list-shared [--gallery-unique-name]
                                    [--ids]
                                    [--location]
                                    [--marker]
                                    [--shared-to {tenant}]
                                    [--show-next-marker]
                                    [--subscription]

Exemplos

Liste uma definição de imagem em uma galeria compartilhada diretamente com sua assinatura no local especificado.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName \
--location myLocation

Liste uma definição de imagem em uma galeria compartilhada diretamente com seu locatário no local especificado.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName \
--location myLocation --shared-to tenant

Parâmetros Opcionais

--gallery-unique-name

O nome exclusivo da Galeria Compartilhada.

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--marker

Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retornará o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, esse gerador começará a retornar os resultados do ponto em que o gerador anterior parou.

--shared-to

O parâmetro de consulta para decidir quais galerias compartilhadas buscar ao fazer operações de listagem. Se não for especificado, liste por id de assinatura.

Valores aceitos: tenant
--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition show

Obtenha informações sobre uma definição de imagem da galeria.

az sig image-definition show [--gallery-image-definition]
                             [--gallery-name]
                             [--ids]
                             [--resource-group]
                             [--subscription]

Parâmetros Opcionais

--gallery-image-definition --gallery-image-name -i

O nome da definição de imagem da galeria a ser recuperada.

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas da qual as Definições de Imagem devem ser recuperadas.

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

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition show-community

Obtenha uma imagem da galeria da comunidade.

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--subscription]

Parâmetros Opcionais

--gallery-image-definition -i

O nome da definição de imagem da galeria da comunidade da qual as versões da imagem devem ser listadas.

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--public-gallery-name

O nome público da galeria da comunidade.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition show-community (image-gallery extensão)

Habilitação

Esse comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha uma imagem em uma comunidade de galerias (versão prévia).

Obtenha uma imagem em uma comunidade da galeria (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por email sigpmdev@microsoft.com para se registrar para visualização se você estiver interessado em usar esse recurso).

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--subscription]

Exemplos

Obtenha uma definição de imagem em uma comunidade da galeria no local especificado.

az sig image-definition show-community --public-gallery-name publicGalleryName \
--gallery-image-definition myGalleryImageName --location myLocation

Parâmetros Opcionais

--gallery-image-definition -i

O nome da definição de imagem da galeria da comunidade da qual as versões da imagem devem ser listadas.

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--public-gallery-name

O nome público da galeria da comunidade.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition show-shared

Obtenha uma imagem da galeria compartilhada.

Obtenha uma imagem da galeria compartilhada que foi compartilhada diretamente para sua assinatura ou locatário.

az sig image-definition show-shared [--gallery-image-definition]
                                    [--gallery-unique-name]
                                    [--ids]
                                    [--location]
                                    [--subscription]

Exemplos

Obtenha uma definição de imagem em uma galeria compartilhada diretamente com sua assinatura ou locatário no local especificado.

az sig image-definition show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition myGalleryImageName --location myLocation

Parâmetros Opcionais

--gallery-image-definition --gallery-image-name -i

O nome da Definição de Imagem da Galeria Compartilhada da qual as versões de imagem devem ser listadas.

--gallery-unique-name

O nome exclusivo da Galeria Compartilhada.

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

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition update

Atualize uma definição de imagem de VM.

az sig image-definition update [--add]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--gallery-image-definition]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--subscription]

Exemplos

Alterar a configuração recomendada da definição de imagem compartilhada

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --set recommended.vCpUs.min=myNewvCpUsMin recommended.vCpUs.max=myNewvCpUsMax recommended.memory.min=myNewMemoryMin recommended.memory.max=myNewMemoryMax description="newDescription"

Remover a propriedade de configuração de uma definição de imagem compartilhada

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --remove recommended.vCpUs.min

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--gallery-image-definition -i

O nome da definição de imagem da galeria a ser recuperada.

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas na qual reside a Definição de Imagem.

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

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

--resource-group -g

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az sig image-definition wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az sig image-definition wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--gallery-image-definition]
                             [--gallery-name]
                             [--ids]
                             [--interval]
                             [--resource-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--gallery-image-definition --gallery-image-name -i

O nome da definição de imagem da galeria a ser recuperada.

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas da qual as Definições de Imagem devem ser recuperadas.

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

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--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.

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.