Partilhar via

az extension

  • Referência

Gerencie e atualize as extensões da CLI.

Comandos

Name Description Tipo Estado
az extension add

Adicione uma extensão.

 Principal GA
az extension list

Liste as extensões instaladas.

 Principal GA
az extension list-available

Listar extensões disponíveis publicamente.

 Principal GA
az extension list-versions

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

 Principal GA
az extension remove

Remova uma extensão.

 Principal GA
az extension show

Mostrar uma extensão.

 Principal GA
az extension update

Atualize uma extensão.

 Principal GA

az extension add

Editar

Adicione 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 do 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 aceites: false, true
--name -n

Nome da extensão.

--pip-extra-index-urls

Lista separada por espaço de URLs extras de índices de pacotes a serem usados. Isso deve apontar para um repositório compatível com PEP 503 (a API de repositório simples) ou 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

Filepath 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 executando 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 predefinido: latest
--yes -y

Não solicite confirmação.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az extension list

Editar

Liste as extensões instaladas.

az extension list
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az extension list-versions

Editar

Liste as 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 Obrigatórios

--name -n

Nome da extensão.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az extension remove

Editar

Remova uma extensão.

az extension remove --name

Exemplos

Remova uma extensão. (gerado automaticamente)

az extension remove --name MyExtension

Parâmetros Obrigatórios

--name -n

Nome da extensão.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--name -n

Nome da extensão.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 pelo 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 Obrigatórios

--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 aceites: false, true
--pip-extra-index-urls

Lista separada por espaço de URLs extras de índices de pacotes a serem usados. Isso deve apontar para um repositório compatível com PEP 503 (a API de repositório simples) ou 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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