Introdução à CLI do Azure

2025-05-22

A CLI do Azure é uma ferramenta multiplataforma que simplifica o gerenciamento de recursos do Azure a partir 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 em seu navegador com o Azure Cloud Shell ou instalá-lo localmente para usá-lo a partir do seu terminal preferido.

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 necessidade de instalação. O Cloud Shell suporta Bash e 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 a 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, ela 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, ele inicia o fluxo de código do dispositivo e instrui você a abrir uma página do navegador em https://aka.ms/devicelogin. Em seguida, insira o código exibido no seu terminal.

Se nenhum navegador da Web estiver disponível ou se o navegador da Web não abrir, você poderá forçar o fluxo de código do dispositivo com az login --use-device-code.
Inicie sessão com as credenciais da sua conta no browser.

Importante

A partir de setembro de 2025, a Microsoft exigirá autenticação multifator (MFA) para a CLI do Azure e outras ferramentas de linha de comando. Essa alteração se aplica somente às identidades de usuário do Microsoft Entra ID e não afeta as identidades de carga de trabalho, como entidades de serviço ou identidades gerenciadas.

Se você estiver usando az login um nome de usuário e senha para autenticar scripts ou fluxos de trabalho automatizados, agora é a hora de migrar 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 iniciar sessão, é apresentada uma lista das suas subscrições. O marcado isDefault: true está atualmente ativo. Para alterar para uma assinatura diferente, execute:

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

Para obter mais informações sobre a seleção de assinaturas, consulte Gerenciar assinaturas do Azure. Para obter opções avançadas de início de sessão, consulte Iniciar sessão 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:

Utilize o comando az find. Por exemplo, para procurar 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 da 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

Aqui está 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.

Explore exemplos e artigos

Para exemplos de uso, consulte:

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

Utilize o índice de artigos para encontrar guias aprofundados. Use as teclas de atalho do teclado find , como Ctrl + F, para encontrar rapidamente o grupo de comandos de referência no qual você está interessado. Por exemplo, o índice do artigo para az vm se parece com a tabela a seguir:

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

Usar autocompletar com a tecla Tab

A CLI do Azure dá suporte ao preenchimento de guias no Bash. Para habilitá-lo no PowerShell, consulte Habilitar conclusão de guia no PowerShell.

Compreender os argumentos globais

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

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

Para obter mais informações, consulte Formatos de saída e 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 ajuda embutida e sugestões de comando. Para saber mais, consulte Modo interativo.

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

Aprenda através de tutoriais e guias de início rápido

Ponha a mão na massa com as noções básicas da CLI do Azure usando o tutorial de integração. Você aprende a:

Observação

Os exemplos da CLI do Azure no Microsoft Learn são escritos para Bash. One-liners geralmente funcionam em diferentes shells, mas scripts multilineares podem exigir ajustes. Para obter mais informações, consulte Aprender diferenças de sintaxe entre Bash, PowerShell e Cmd

Fornecer comentários

Agradecemos o seu feedback. Envie problemas no GitHub ou execute:

az feedback

Partilhar via