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.

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

Consulte também