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 uso interativo, você primeiro inicia um shell, como cmd.exe no Windows, ou Bash no Linux ou macOS e, em seguida, emite 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.

Você pode instalar a CLI do Azure localmente em computadores Linux, macOS ou Windows. Ele também pode ser usado de 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 obter informações sobre a versão mais recente, veja as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, 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 simplesreference nameparameter - parameter valuecommand - - . 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 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 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

Escolha a ferramenta de linha de comando certa explica a diferença entre tools e environments com ênfase na CLI do Azure e no Azure PowerShell. Ele também dá 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> -Localização 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 Aprender as diferenças de sintaxe da CLI do Azure em 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. Eis um exemplo:

az account list --output table

Defina sua saída padrão definindo a output propriedade de configuração conforme descrito na configuração da CLI do Azure.

az config set core.output=jsonc

Recolha de dados

A CLI do Azure coleta dados de telemetria por padrão. A Microsoft agrega dados coletados para identificar padrões de uso, identificar problemas comuns e melhorar a experiência da CLI do Azure. A CLI do Microsoft Azure não coleta 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 consideremos útil receber estes dados, também compreendemos que nem todas as pessoas pretendem enviar os dados de utilização. Você pode desabilitar a coleta 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.

Consulte Também