Introdução à CLI do Azure

Bem-vindo à Interface Command-Line Azure (CLI)! Este artigo introduz o CLI e ajuda-o a completar tarefas comuns.

Nota

Nos scripts e no site de documentação da Microsoft, os exemplos da CLI do Azure são escritos para o shell bash. Os exemplos em uma linha executam em qualquer plataforma. Os maiores exemplos que incluem linhas contínuas (\) ou atribuições de variáveis precisam de ser modificados para funcionar em outros shells, incluindo o PowerShell.

Instalar ou executar no Azure Cloud Shell

A maneira mais fácil de aprender a usar o CLI Azure é executá-lo num ambiente Azure Cloud Shell através do seu navegador. Para saber mais sobre o Cloud Shell, veja Início Rápido do Bash no Azure Cloud Shell.

Quando estiver preparado para instalar a CLI, veja as instruções de instalação.

Depois de instalar o CLI pela primeira vez, verifique se está instalado e que tem a versão correta executando az --version.

Nota

Se estiver a utilizar o modelo de implementação clássica do Azure, instale a CLI clássica do Azure.

Como assinar no Azure CLI

Antes de utilizar quaisquer comandos Azure CLI com uma instalação local, tem de iniciar sessão com início de sessão.

  1. Execute o comando login.

    az login
    

    Se o CLI conseguir abrir o seu navegador predefinido, iniciará o fluxo de código de autorização e abrirá o navegador predefinido para carregar uma página de início de sposição do Azure.

    Caso contrário, iniciará o fluxo de código do dispositivo e irá dizer-lhe para abrir uma página de https://aka.ms/devicelogin navegador e introduzir o código exibido no seu terminal.

    Se nenhum navegador da Web estiver disponível ou o navegador web não abrir, poderá forçar o fluxo de código do dispositivo com o código de acesso az --use-device-code.

  2. Inicie sessão com as credenciais da sua conta no browser.

Depois de iniciar sessão, vê uma lista de subscrições associadas à sua conta Azure. A informação de subscrição com isDefault: true é a subscrição ativada atualmente após o início de sessão. Para selecionar outra subscrição, utilize o comando conjunto de conta az com o ID de subscrição para mudar. Para obter mais informações sobre a seleção de subscrição, consulte utilizar várias subscrições do Azure.

Existem formas de iniciar sessão de forma não interativa, que são abordadas em detalhe em Iniciar sessão com a CLI do Azure.

Comandos comuns da CLI Azure

Esta tabela lista alguns comandos comuns utilizados na CLI, bem como ligações para a documentação de referência dos mesmos.

Tipo de recurso Grupo de comandos da CLI do Azure
Grupo de recursos az group
Máquinas virtuais az vm
Contas de armazenamento az storage account
Cofre de Chaves az keyvault
Aplicações Web az webapp
Bases de Dados SQL az sql server
Cosmos DB az cosmosdb

Encontrar os comandos

Os comandos Azure CLI são organizados como comandos de grupos. Cada grupo representa um serviço do Azure e os comandos operam nesse serviço.

Para procurar os comandos, utilize az find. Por exemplo, para procurar os nomes dos comando que contenham secret, utilize o seguinte comando:

az find secret

Utilize o argumento --help para obter uma lista completa de comandos e subgrupos de um grupo. Por exemplo, para localizar os comandos da CLI para trabalhar com Grupos de Segurança de Rede (NSGs):

az network nsg --help

A CLI tem conclusão de separadores completa para comandos na shell de deteção.

Argumentos globalmente disponíveis

Existem alguns argumentos que estão disponíveis para todos os comandos.

  • --help imprime as informações de referência da CLI sobre comandos e os respetivos argumentos, bem como apresenta uma lista dos comandos e subgrupos disponíveis.
  • --output muda o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados de Separados a Separados do Separador), table (tabelas ASCII legíveis pelo homem) e yaml. Por predefinição, a CLI produz json. Para saber mais sobre os formatos de saída disponíveis, veja Formatos de saída para a CLI do Azure.
  • --query utiliza a Linguagem de Consulta JMESPath para filtrar os resultados devolvidos pelo serviços do Azure. Para saber mais sobre consultas, consulte os resultados do comando da Consulta com o Azure CLI e o tutorial JMESPath.
  • --verbose imprime informações sobre os recursos criados no Azure durante uma operação e outras informações úteis.
  • --debug imprime ainda mais informações sobre as operações da CLI utilizadas para efeitos de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.

Modo interativo

A CLI oferece um modo interativa que mostra automaticamente as informações de ajuda e torna mais fácil selecionar os subcomandos. Pode entrar no modo interativo com o comando az interactive.

az interactive

Para obter mais informações sobre o modo interativo, veja Modo Interativo da CLI do Azure.

Há também um plug-in do Visual Studio Code que oferece uma experiência interativa, incluindo documentação de conclusão automática e à passagem do rato.

Aprender as noções básicas da CLI com inícios rápidos e tutoriais

Para aprender a usar o Azure CLI, experimente um tutorial aprofundado para a criação de máquinas virtuais e utilizando o poder do CLI para consultar os recursos do Azure.

Também existem inícios rápidos para outros serviços populares.

Enviar comentários

Apreciamos os seus comentários para a CLI para ajudar-nos a melhorar e resolver erros. Pode arquivar um problema no GitHub ou utilizar as funcionalidades incorporadas do CLI para deixar feedback geral com o comando de feedback az .

az feedback

Ver também