Compartilhar via


az vm extension image

Localize as extensões de VM disponíveis para uma assinatura e uma região.

Comandos

Nome Description Tipo Status
az vm extension image list

Liste as informações sobre extensões disponíveis.

Core GA
az vm extension image list-names

Liste os nomes das extensões disponíveis.

Core GA
az vm extension image list-versions

Liste as versões para extensões disponíveis.

Core GA
az vm extension image show

Exibir informações de uma extensão.

Core GA

az vm extension image list

Liste as informações sobre extensões disponíveis.

az vm extension image list [--latest]
                           [--location]
                           [--name]
                           [--publisher]
                           [--version]

Exemplos

Liste os editores exclusivos para extensões.

az vm extension image list --query "[].publisher" -o tsv | sort -u

Localize extensões com "Docker" no nome.

az vm extension image list --query "[].name" -o tsv | sort -u | grep Docker

Listar nomes de extensão em que o nome do editor começa com "Microsoft.Azure.App".

az vm extension image list --query \
    "[?starts_with(publisher, 'Microsoft.Azure.App')].publisher" \
    -o tsv | sort -u | xargs -I{} az vm extension image list-names --publisher {} -l westus

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.

--latest

Mostrar somente a versão mais recente.

Propriedade Valor
Valor padrão: False
--location -l

Local da imagem.

--name -n

Nome da imagem.

--publisher -p

Nome do editor de imagens.

--version

Versão da extensão.

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.

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

Propriedade Valor
Valor padrão: False

az vm extension image list-names

Liste os nomes das extensões disponíveis.

az vm extension image list-names [--ids]
                                 [--location]
                                 [--publisher --publisher-name]
                                 [--subscription]

Exemplos

Localize as extensões do Docker por publicador e local.

az vm extension image list-names --publisher Microsoft.Azure.Extensions -l westus --query "[?starts_with(name, 'Docker')]"

Localize extensões CustomScript por publicador e local.

az vm extension image list-names --publisher Microsoft.Azure.Extensions -l westus --query "[?starts_with(name, 'Custom')]"

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.

--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
--location -l

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

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

Nome do editor de imagens.

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 vm extension image list-versions

Liste as versões para extensões disponíveis.

az vm extension image list-versions [--filter]
                                    [--ids]
                                    [--location]
                                    [--name --type]
                                    [--orderby]
                                    [--publisher --publisher-name]
                                    [--subscription]
                                    [--top]

Exemplos

Localize as versões disponíveis para a extensão do Docker.

az vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension -o table

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.

--filter

O filtro a ser aplicado na operação. O valor padrão é None.

--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
--location -l

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

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

Nome da extensão.

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

A opção de consulta odata $orderby.

--publisher --publisher-name -p

Nome do editor de imagens.

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

A opção de consulta odata $top.

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 vm extension image show

Exibir informações de uma extensão.

az vm extension image show [--ids]
                           [--location]
                           [--name --type]
                           [--publisher --publisher-name]
                           [--subscription]
                           [--version]

Exemplos

Mostrar a extensão CustomScript versão 2.0.2.

az vm extension image show -l westus -n CustomScript --publisher Microsoft.Azure.Extensions --version 2.0.2

Mostrar a versão mais recente da extensão do Docker.

az vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension --query "[].name" -o tsv | sort | tail -n 1
az vm extension image show -l westus --publisher Microsoft.Azure.Extensions -n DockerExtension --version LatestVersion

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.

--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
--location -l

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

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

Nome da extensão.

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

Nome do editor de imagens.

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

Versão da extensão.

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