Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A Azure Command-Line Interface (CLI) é uma ferramenta de linha de comandos multiplataforma para se ligar a Azure e executar comandos administrativos em recursos Azure. Permite a execução de comandos através de um terminal com pedidos de linha de comandos interativos ou um script.
Para uso interativo, primeiro lanças um shell como o cmd.exe no Windows, ou Bash no Linux ou macOS, e depois emites um comando no prompt do shell. Para automatizar tarefas repetitivas, monte os comandos da CLI em um shell script usando a sintaxe de script do shell escolhido e, em seguida, execute o script.
Podes instalar o Azure CLI localmente em computadores Linux, macOS ou Windows. Também pode ser usado a partir de um navegador através do Azure Cloud Shell ou executado dentro de um contentor Docker.
Versão Atual
A versão atual do Azure CLI é 2.84.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.
Autenticação
O Azure CLI suporta vários métodos de autenticação. Para informações detalhadas sobre autenticação a Azure a partir da Azure CLI, veja Iniciar sessão com Azure CLI.
Projeto de referência para comandos
A sintaxe Azure CLI segue um padrão simples reference name - command - parameter - parameter value. Por exemplo, alternar entre subscrições é muitas vezes uma tarefa comum. Aqui está a sintaxe.
az account set --subscription "my subscription name"
Outro uso comum da Azure CLI é a gestão de atribuições de funções.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Para mais informações sobre gestão de subscrições, consulte Gerenciar subscrições com Azure CLI. Consulte Crie um princípio de serviço Azure com o Azure CLI para um tutorial aprofundado sobre gestão de princípios de serviço e atribuições de funções.
Comparação de sintaxe do PowerShell
Escolha a ferramenta de linha de comandos certa explica a diferença entre tools e environments com ênfase no Azure CLI e Azure PowerShell. Ele também dá muitas comparações de comandos lado a lado. Veja a seguir dois exemplos:
| Comando | Azure CLI | Azure PowerShell |
|---|---|---|
| Criar Grupo de Recursos | az group create --name <ResourceGroupName> --location eastus | New-AzResourceGroup -Name <ResourceGroupName> -Localização leste dos EUA |
| Criar uma Conta Azure Storage | az storage account criar ---name <StorageAccountName> ---resource-group <ResourceGroupName> ---location eastus --sku Standard_LRS --kind StorageV2 | <New-AzStorageAccount -Name StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location eastus -SkuName Standard_LRS -Kind StorageV2 |
Para comparações de sintaxe Azure CLI entre ambientes Bash e PowerShell, veja Learn Azure CLI diferenças de sintaxe em Bash, PowerShell e Cmd.
Formatos de saída
O Azure CLI usa JSON como formato de saída predefinido, mas oferece outros formatos conforme descrito nos formatos Output para comandos Azure CLI. Use o parâmetro --output para formatar os resultados Azure CLI comandos. Aqui está um exemplo:
az account list --output table
Defina a saída padrão ao definir a propriedade de configuração output, conforme descrito na configuração do Azure CLI.
az config set core.output=jsonc
Recolha de dados
O Azure CLI recolhe dados de telemetria por defeito. A Microsoft agrega dados recolhidos para identificar padrões de utilização, identificar problemas comuns e melhorar a experiência do Azure CLI. A Microsoft Azure CLI não recolhe quaisquer dados privados ou pessoais. Por exemplo, os dados de uso ajudam a identificar problemas como comandos com baixo sucesso e ajudam a priorizar nosso trabalho.
Embora apreciemos os insights que esses dados fornecem, também entendemos que nem todos querem enviar dados de uso. Você pode desabilitar a coleta de dados com o az config set core.collect_telemetry=false comando. Pode também ler a nossa declaração de privacidade para obter mais informações.
Ver também
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.
