O que é a CLI do Azure?
A Interface de Linha de Comandos (CLI) do Azure é uma ferramenta de linha de comandos entre plataformas para ligar ao Azure e executar comandos administrativos em recursos do Azure. Permite a execução de comandos através de um terminal com pedidos de linha de comandos interativos ou um script.
Para utilização interativa, primeiro inicia uma shell, como cmd.exe no Windows ou Bash no Linux ou macOS e, em seguida, emite um comando na linha de comandos da shell. Para automatizar tarefas repetitivas, pode montar os comandos da CLI num script de shell com a sintaxe de script da shell escolhida e, em seguida, executar o script.
Pode instalar a CLI do Azure localmente em computadores Linux, Mac ou Windows. Também pode ser utilizada num browser através do Azure Cloud Shell ou executada num contentor do Docker.
Versão Atual
A versão atual da CLI do Azure é a 2.44.1. Para obter informações sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se precisa de atualizar, execute az version.
Recolha de dados
A CLI do Azure recolhe dados telemétricos por predefinição. A Microsoft agrega dados recolhidos para identificar padrões de utilização para identificar problemas comuns e melhorar a experiência da CLI do Azure. A CLI do Microsoft Azure não recolhe quaisquer dados privados ou pessoais. Por exemplo, os dados de utilização ajudam a identificar problemas como comandos com pouco sucesso e ajudam a priorizar o nosso trabalho.
Embora consideremos útil receber estes dados, também compreendemos que nem todas as pessoas pretendem enviar os dados de utilização. Pode desativar a recolha de dados com o az config set core.collect_telemetry=false comando . Também pode ser a nossa declaração de privacidade para saber mais.
Preparar o ambiente
Antes de executar comandos da CLI do Azure, tem de configurar o seu ambiente.
Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.
Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
Exemplos da CLI do Azure
Este artigo fornece diferentes exemplos da CLI do Azure para o seguinte:
- Sintaxe da subscrição
- Sintaxe de atribuição de função
- Sintaxe do PowerShell
Exemplo de sintaxe da subscrição
A sintaxe da CLI do Azure segue um padrão simplesreference nameparameter - parameter valuecommand - - . Por exemplo, alternar entre subscrições é, muitas vezes, uma tarefa comum. Eis a sintaxe.
az account set --subscription "my subscription name"
Agora, quão fácil foi isto?! Veja Gerir subscrições com a CLI do Azure para saber mais sobre como utilizar a CLI do Azure para trabalhar com subscrições e criar grupos de gestão.
Exemplo de sintaxe de atribuição de função
Outra utilização comum da CLI do Azure é 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
Veja Criar um principal de serviço do Azure com a CLI do Azure para obter uma turorial aprofundada sobre a gestão de principais de serviço e atribuições de funções.
Comparação da sintaxe do PowerShell
Escolher a ferramenta de linha de comandos certa explica a diferença entre tools e environments com ênfase na CLI do Azure e Azure PowerShell. Também fornece muitas comparações de comandos lado a lado. Veja a seguir 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 |