Compartilhar via

az extension

  • Referência

Gerencia e atualiza as extensões da CLI.

Comandos

Nome Description Tipo Status
az extension add

Adiciona uma extensão.

 Núcleo GA
az extension list

Liste as extensões instaladas.

 Núcleo GA
az extension list-available

Listar extensões disponíveis publicamente.

 Núcleo GA
az extension list-versions

Listar versões disponíveis para uma extensão.

 Núcleo GA
az extension remove

Remove uma extensão.

 Núcleo GA
az extension show

Mostrar uma extensão.

 Núcleo GA
az extension update

Atualize uma extensão.

 Núcleo GA

az extension add

Editar

Adiciona uma extensão.

Para saber mais sobre como instalar extensões automaticamente, visite https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Exemplos

Adicionar extensão por nome

az extension add --name anextension

Adicionar extensão da URL

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Adicionar extensão do disco local

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Adicionar extensão do disco local e usar proxy pip para dependências

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Adicionar extensão ao diretório do sistema

az extension add --name anextension --system

Adicionar uma versão específica da extensão

az extension add --name anextension --version 1.0.0

Atualize a extensão, se já estiver instalada

az extension add --upgrade --name anextension

Parâmetros Opcionais

--allow-preview

Inclua pacotes de visualização para instalação de extensão, se existir.

valores aceitos: false, true
--name -n

Nome da extensão.

--pip-extra-index-urls

Lista separada por espaço de URLs extras dos índices de pacotes a serem usados. Isso precisará apontar para um repositório que esteja em conformidade com o PEP 503 (a API de repositório simples) ou com um diretório local disposto no mesmo formato.

--pip-proxy

Proxy para pip a ser usado para dependências de extensão na forma de [user:passwd@]proxy.server:port.

--source -s

Caminho de arquivo ou URL para uma extensão.

--system

Use um diretório do sistema para a extensão.

O caminho padrão é a pasta azure-cli-extensions na CLI que executa o caminho lib do ambiente python, configurável pela variável de ambiente AZURE_EXTENSION_SYS_DIR. No Windows, talvez seja necessário abrir o shell como Administrador para executar com a permissão correta.

--upgrade

Atualize a extensão se já estiver instalada, caso contrário, basta instalar a extensão.

--version

A versão específica de uma extensão.

valor padrão: latest
--yes -y

Não solicite confirmaçã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 extension list

Editar

Liste as extensões instaladas.

az extension list
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 extension list-available

Editar

Listar extensões disponíveis publicamente.

az extension list-available [--show-details]

Exemplos

Listar todas as extensões disponíveis publicamente

az extension list-available

Listar detalhes sobre uma extensão específica

az extension list-available --show-details --query anextension

Parâmetros Opcionais

--show-details -d

Mostrar os dados brutos do índice de extensão.

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.

az extension list-versions

Editar

Listar versões disponíveis para uma extensão.

az extension list-versions --name

Exemplos

Listar versões disponíveis para uma extensão

az extension list-versions --name anextension

Parâmetros Exigidos

--name -n

Nome da extensã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 extension remove

Editar

Remove uma extensão.

az extension remove --name

Exemplos

Remove uma extensão. (gerado automaticamente)

az extension remove --name MyExtension

Parâmetros Exigidos

--name -n

Nome da extensã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 extension show

Editar

Mostrar uma extensão.

az extension show --name

Exemplos

Mostrar uma extensão. (gerado automaticamente)

az extension show --name MyExtension

Parâmetros Exigidos

--name -n

Nome da extensã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 extension update

Editar

Atualize uma extensão.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Exemplos

Atualizar uma extensão por nome

az extension update --name anextension

Atualizar uma extensão por nome e usar proxy pip para dependências

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Parâmetros Exigidos

--name -n

Nome da extensão.

Parâmetros Opcionais

--allow-preview

Inclua pacotes de visualização para instalação de extensão, se existir.

valores aceitos: false, true
--pip-extra-index-urls

Lista separada por espaço de URLs extras dos índices de pacotes a serem usados. Isso precisará apontar para um repositório que esteja em conformidade com o PEP 503 (a API de repositório simples) ou com um diretório local disposto no mesmo formato.

--pip-proxy

Proxy para pip a ser usado para dependências de extensão na forma de [user:passwd@]proxy.server:port.

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.