O que é a CLI do Azure?
A CLI (Interface de Linha de Comando) do Azure é uma ferramenta de linha de comando multiplataforma usada para se conectar ao Azure, além de executar comandos administrativos em recursos do Azure. Ela permite a execução de comandos por meio de um terminal usando prompts de linha de comando interativos ou um script.
Para uso interativo, primeiro, inicie um shell como cmd.exe no Windows, ou um Bash no Linux ou no macOS e, em seguida, emita um comando no prompt do shell. Para automatizar tarefas repetitivas, reúna os comandos da CLI em um script do shell usando a sintaxe de script do shell escolhido e execute o script.
Você pode instalar a CLI do Azure localmente em computadores Linux, macOS ou Windows. Ele também pode ser usado em um navegador por meio do Azure Cloud Shell ou executado de dentro de um contêiner do Docker.
Versão atual
A versão atual da CLI do Azure é 2.63.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.
Autenticação
A CLI do Azure dá suporte a vários métodos de autenticação. Para obter informações detalhadas sobre como autenticar no Azure a partir da CLI do Azure, consulte Entrar com a CLI do Azure.
Design de referência de comando
A sintaxe da CLI do Azure segue um padrão reference name - command - parameter - parameter value simples. Por exemplo, alternar entre assinaturas geralmente é uma tarefa comum. Veja a síntese.
az account set --subscription "my subscription name"
Outro uso comum da CLI do Azure é gerenciar atribuições de função.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Para obter mais informações sobre como gerenciar assinaturas, consulte Gerenciar assinaturas com a CLI do Azure. Consulte em Criar uma entidade de serviço do Azure com a CLI do Azure para obter um tutorial detalhado sobre como gerenciar entidades de serviço e atribuições de função.
Comparação de sintaxe do PowerShell
Escolher a ferramenta de linha de comando correta explica a diferença entre tools e environments, com ênfase na CLI do Azure e no Azure PowerShell. Também fornece muitas comparações de comandos lado a lado. Veja dois exemplos:
| Comando | CLI do Azure | Azure PowerShell |
|---|---|---|
| Criar grupo de recursos | az group create --name <ResourceGroupName> --location eastus | New-AzResourceGroup -Name <ResourceGroupName> -Location eastus |
| Criar uma Conta de Armazenamento do Azure | az storage account create --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 da CLI do Azure entre ambientes Bash e PowerShell, consulte Saiba mais sobre as diferenças de sintaxe da CLI do Azure no Bash, PowerShell e Cmd.
Formatos de saída
A CLI do Azure usa JSON como seu formato de saída padrão, mas oferece outros formatos, conforme descrito em Formatos de saída para comandos da CLI do Azure. Use o parâmetro para formatar os resultados do --output comando da CLI do Azure. Veja um exemplo:
az account list --output table
Defina sua saída padrão definindo a propriedade de configuração conforme descrito na configuração da output CLI do Azure.
az config set core.output=jsonc
Coleta de dados
A CLI do Azure coleta dados telemétricos por padrão. A Microsoft agrega dados coletados não só para identificar padrões de uso e problemas comuns, mas também para aprimorar a experiência da CLI do Azure. A CLI do Azure da Microsoft não coleta dados privados ou pessoais. Por exemplo, os dados de uso ajudam a identificar problemas, como comandos com baixo índice de sucesso, e a priorizar o trabalho.
Embora apreciemos os insights fornecidos por esses dados, também entendemos que nem todos desejam enviar dados de uso. Você pode desabilitar a coleta de dados com o comando az config set core.collect_telemetry=false. Você também pode ler a nossa política de privacidade para saber mais.
