Compartilhar via


az sig image-definition

Observação

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.

Gerenciar imagem de galeria compartilhada com VM.

Comandos

Nome Description Tipo Status
az sig image-definition create

Crie uma definição de imagem de galeria.

Núcleo GA
az sig image-definition delete

Excluir 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 galeria.

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

Listar definições de imagem de VM em uma comunidade de galeria (visualização).

Extensão Habilitação
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 de 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)

Obter uma imagem em uma comunidade da galeria (visualização).

Extensão Habilitação
az sig image-definition show-shared

Obtenha uma imagem de 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 de 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 linux especializadas

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 especializadas 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 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 oferecem 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 oferecem 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 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=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 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=TrustedLaunchAndConfidentialVmSupported

Criar uma definição de imagem e indicar a data de fim de 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ínimas e máximas (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

Crie uma definição de imagem e indique 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

Crie uma definição de imagem e forneça o EULA, o URI da declaração de privacidade e o URI das notas de versã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 \
--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 de sistema operacional incluído no disco se estiver criando uma VM a partir de uma imagem do usuário ou de um VHD especializado.

Valores aceitos: Linux, Windows
--publisher -p

Editora 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

Imagem sku.

Parâmetros Opcionais

--architecture

Arquitetura de CPU.

Valores aceitos: Arm64, x64
--description

A descrição da definição da 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 de vida, por exemplo, '2020-12-31'.

--eula

O acordo de 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 apenas a discos do sistema operacional.

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

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

--maximum-cpu-core

Máximo de núcleos de cpu.

--maximum-memory

Memória máxima em MB.

--minimum-cpu-core

Núcleos de cpu mínimos.

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

--plan-publisher

Planejar editor.

--privacy-statement-uri

O uri da declaração de privacidade.

--release-note-uri

O uri da nota de versão.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

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 sig image-definition delete

Excluir 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

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

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 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 sig image-definition list

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

az sig image-definition list --gallery-name
                             --resource-group

Parâmetros Exigidos

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas a partir 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 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 sig image-definition list-community

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

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

Exemplos

Listar uma definição de imagem em uma comunidade de 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--location -l

Local. 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 retorna 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, este gerador começará a retornar resultados do ponto onde 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 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 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 galeria (visualização).

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

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

Exemplos

Listar uma definição de imagem em uma comunidade de 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--location -l

Local. 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 retorna 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, este gerador começará a retornar resultados do ponto onde 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 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 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--location -l

Local. 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 retorna 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, este gerador começará a retornar resultados do ponto onde 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 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 sig image-definition show

Obtenha informações sobre uma definição de imagem de 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--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 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 a partir da qual as versões da imagem devem ser listadas.

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

--location -l

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

Obter uma imagem em uma comunidade da galeria (visualização).

Obter 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 e-mail sigpmdev@microsoft.com para se registrar para visualização se 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 de 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 a partir da qual as versões da imagem devem ser listadas.

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

--location -l

Local. 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 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 sig image-definition show-shared

Obtenha uma imagem de galeria compartilhada.

Obtenha uma imagem de galeria compartilhada que tenha sido compartilhada diretamente com 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 a partir 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--location -l

Local. 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 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 sig image-definition update

Atualize uma definição de imagem de VM.

az sig image-definition update --gallery-image-definition
                               --gallery-name
                               --resource-group
                               [--add]
                               [--force-string]
                               [--remove]
                               [--set]

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 Exigidos

--gallery-image-definition -i

Definição de imagem da galeria.

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--add

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

Valor padrão: []
--force-string

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

Valor padrão: False
--remove

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

Valor padrão: []
--set

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

Valor padrão: []
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 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é criar com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição satisfaç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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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