Introdução à CLI do Azure

2025-05-22

A CLI do Azure é uma ferramenta multiplataforma que simplifica o gerenciamento de recursos do Azure da linha de comando. Otimizado para automação e facilidade de uso, ele dá suporte a sessões interativas e scripts com comandos simples que se integram perfeitamente ao modelo do Azure Resource Manager. Você pode começar a usá-lo no navegador com o Azure Cloud Shell ou instalá-lo localmente para usar no terminal preferencial.

Instalar ou executar no Azure Cloud Shell

A maneira mais fácil de experimentar a CLI do Azure é por meio do Azure Cloud Shell, um shell baseado em navegador sem a necessidade de instalação. O Cloud Shell dá suporte ao Bash e ao PowerShell e vem com a versão mais recente da CLI do Azure pré-instalada.

Para instalar a CLI do Azure localmente, consulte Como instalar a CLI do Azure.

Para verificar sua versão, execute:

az version

Para começar a usar a CLI do Azure com uma instalação local, entre:

Execute o comando az login.
```
az login
```
Se a CLI do Azure puder abrir seu navegador padrão, ele iniciará o fluxo de código de autorização e abrirá o navegador padrão para carregar uma página de entrada do Azure.

Caso contrário, ela iniciará o fluxo de código do dispositivo e instruirá você a abrir uma página do navegador em https://aka.ms/devicelogin. Em seguida, insira o código exibido no terminal.

Se nenhum navegador da Web estiver disponível ou o navegador da Web não for aberto, você poderá forçar o fluxo de código do dispositivo com az login --use-device-code.
Entre com suas credenciais de conta no navegador.

Importante

A partir de 2025, a Microsoft imporá a MFA obrigatória para a CLI do Azure e outras ferramentas de linha de comando. A MFA afetará apenas as identidades de usuário da ID do Microsoft Entra . Isso não afetará identidades de trabalho, como principais de serviço e identidades gerenciadas.

Se você estiver usando az login com uma ID do Entra e uma senha para autenticar um script ou um processo automatizado, planeje migrar agora para uma identidade de carga de trabalho. Para obter mais informações, consulte o impacto da autenticação multifator na CLI do Azure em cenários de automação.

Depois de entrar, uma lista de suas assinaturas será exibida. O marcado isDefault: true está ativo no momento. Para alterar para uma assinatura diferente, execute:

az account set --subscription "<subscription-id>"

Para obter mais informações sobre a seleção de assinatura, consulte Gerenciar assinaturas do Azure. Para obter opções avançadas de entrada, consulte Entrar com a CLI do Azure.

Localizar comandos

Os comandos da CLI do Azure são organizados como grupos de comandos. Cada grupo representa uma área de um serviço do Azure. Há duas opções para localizar grupos de comandos:

Use o comando az find. Por exemplo, para pesquisar nomes de comando contendo vm, use o seguinte exemplo:
```
az find vm
```

Use o --help argumento para obter uma lista completa de subgrupos dentro de um grupo de referência. O exemplo a seguir retorna todos os subgrupos para máquinas virtuais:

az vm --help

O exemplo a seguir mostra a parte relevante da saída.

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

A saída de ajuda inclui subgrupos, parâmetros, opções de autenticação e exemplos.

Aqui está outro exemplo que localiza os comandos da CLI do Azure para agrupar máquinas virtuais em conjuntos de disponibilidade, um subgrupo de az vm:

az vm availability-set --help

Você também pode usar --help para obter listas de parâmetros e exemplos de comando para um comando de referência.

az vm create --help

Esta é a seção relevante da saída de exemplo:

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

Use o índice de referência que lista todos os grupos de comandos em ordem alfabética.

Explorar exemplos e artigos

Para obter exemplos de uso, consulte:

O índice de exemplos para exemplos da CLI do Azure por assunto, grupo de referência ou repositório GitHub.

O índice de artigo para localizar guias detalhados. Use as teclas de atalho de teclado find , como Ctrl + F, para localizar rapidamente o grupo de comandos de referência no qual você está interessado. Por exemplo, o índice de artigo para az vm é semelhante à tabela a seguir:

Subgrupo de referência	Artigo da CLI do Azure mostrando o uso de referências
az vm	Formatos de saída dos comandos da CLI do Azure
	Como usar variáveis em comandos da CLI do Azure
	Obter informações da VM com consultas
	{Mais artigos listados aqui.}
az vm aem	Nova versão da extensão de VM do Azure para SAP
	Versão padrão da extensão de VM do Azure para soluções SAP
az vm application	{...}

Use completar com a tecla Tab

A CLI do Azure dá suporte à conclusão da guia no Bash. Para habilitá-lo no PowerShell, consulte Habilitar a conclusão da guia no PowerShell.

Entender argumentos globais

Os argumentos comuns disponíveis para a maioria dos comandos incluem:

Argumento	Descrição
`--help`	Exibir ajuda de comando
`--output`	Alterar o formato de saída: `json`, , `jsonc`, `tsv`, , `tableyaml`
`--query`	Filtrar a saída usando JMESPath
`--verbose`	Imprimir mais detalhes de execução
`--debug`	Mostrar chamadas REST de nível baixo para depuração
`--subscription`	Especificar o nome ou a ID da assinatura
`--only-show-errors`	Suprimir saída não crítica

Para obter mais informações, consulte os formatos de saída e os resultados da consulta.

Usar o modo interativo

Execute o modo interativo com:

az interactive

O modo interativo inicia uma experiência aprimorada da CLI do Azure com sugestões de comando e ajuda embutidas. Para obter mais informações, consulte Modo Interativo.

Uma extensão opcional do VS Code fornece recursos semelhantes com dicas de preenchimento automático e focalização.

Aprenda por meio de tutoriais e guias de início rápido

Obtenha as noções básicas da CLI do Azure usando o tutorial de integração. Você aprenderá como:

Observação

Exemplos da CLI do Azure no Microsoft Learn são escritos para Bash. Comandos de uma linha geralmente funcionam em diferentes shells, mas scripts de várias linhas podem exigir ajustes. Para obter mais informações, consulte As diferenças de sintaxe do Learn entre Bash, PowerShell e Cmd

Fornecer comentários

Agradecemos seus comentários. Envie problemas no GitHub ou execute:

az feedback

Compartilhar via