Compartilhar via

az extension

Gerencia e atualiza as extensões da CLI.

Comandos

Nome Description Tipo Status
az extension add

Adicione uma extensão.

 Core GA
az extension list

Liste as extensões instaladas.

 Core GA
az extension list-available

Listar extensões disponíveis publicamente.

 Core GA
az extension list-versions

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

 Core GA
az extension remove

Remova uma extensão.

 Core GA
az extension show

Mostrar uma extensão.

 Core GA
az extension update

Atualize uma extensão.

 Core 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 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 o 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

Atualizar a extensão se já estiver instalada

az extension add --upgrade --name anextension

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.

--allow-preview

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

Propriedade Valor
Valores aceitos: false, true
--name -n

Nome da extensão.

--pip-extra-index-urls

Lista separada por espaço de URLs extras de índices de pacote a serem usados. Isso deve apontar para um repositório compatível com PEP 503 (a API do repositório simples) ou um diretório local disposto no mesmo formato.

Propriedade Valor
Grupo de parâmetros: Experimental Pip Arguments
--pip-proxy

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

Propriedade Valor
Grupo de parâmetros: Experimental Pip Arguments
--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 de ambiente python, configurável por 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 certa.

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

Propriedade Valor
Valor padrão: latest
--yes -y

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

--verbose

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

Propriedade Valor
Valor padrão: False

az extension list

Editar

Liste as extensões instaladas.

az extension list
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 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 em uma extensão específica

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

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.

--show-details -d

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

Propriedade Valor
Valor padrão: False
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 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 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 extension remove

Editar

Remova uma extensão.

az extension remove --name

Exemplos

Remova uma extensão. (autogenerated)

az extension remove --name MyExtension

Parâmetros Exigidos

--name -n

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

--verbose

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

Propriedade Valor
Valor padrão: False

az extension show

Editar

Mostrar uma extensão.

az extension show --name

Exemplos

Mostrar uma extensão. (autogenerated)

az extension show --name MyExtension

Parâmetros Exigidos

--name -n

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

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.

--allow-preview

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

Propriedade Valor
Valores aceitos: false, true
--pip-extra-index-urls

Lista separada por espaço de URLs extras de índices de pacote a serem usados. Isso deve apontar para um repositório compatível com PEP 503 (a API do repositório simples) ou um diretório local disposto no mesmo formato.

Propriedade Valor
Grupo de parâmetros: Experimental Pip Arguments
--pip-proxy

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

Propriedade Valor
Grupo de parâmetros: Experimental Pip 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