Partilhar via

az extension

Gerencie e atualize as extensões da CLI.

Comandos

Name Description Tipo Status
az extension add

Adicione uma extensão.

 Core disponibilidade geral
az extension list

Liste as extensões instaladas.

 Core disponibilidade geral
az extension list-available

Listar extensões disponíveis publicamente.

 Core disponibilidade geral
az extension list-versions

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

 Core disponibilidade geral
az extension remove

Remova uma extensão.

 Core disponibilidade geral
az extension show

Mostrar uma extensão.

 Core disponibilidade geral
az extension update

Atualize uma extensão.

 Core disponibilidade geral

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-preview

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

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

Propriedade Valor
Parameter group: 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
Parameter group: 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 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.

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 sobre uma extensão específica

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--show-details -d

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

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-preview

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

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

Propriedade Valor
Parameter group: 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
Parameter group: Experimental Pip Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False