Prepare o seu ambiente para a Azure CLI

2025-09-02

Nesta etapa do tutorial, você executa seus primeiros comandos da CLI do Azure. Isso inclui localizar e definir sua assinatura ativa e definir valores padrão. Você também aprende a criar grupos de recursos contendo uma ID aleatória para sempre garantir um nome de recurso exclusivo.

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Para concluir esta etapa do tutorial, precisas de permissões de nível contributor ou superiores na tua subscrição.

Instalar a CLI do Azure

Comece selecionando seu ambiente.

Use o ambiente Bash no Azure Cloud Shell selecionando o botão Open Cloud Shell no canto superior direito de cada bloco de código da CLI do Azure.
Se preferir executar os comandos de referência da CLI do Azure localmente, instale a CLI do Azure.

A versão atual da CLI do Azure é 2.77.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Há várias opções de autenticação ao trabalhar com a CLI do Azure. O método de autenticação padrão da CLI do Azure para logons usa um navegador da Web e um token de acesso para entrar.

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.

Localizar e alterar a sua subscrição ativa

Depois de iniciar sessão na CLI do Azure, verifique sempre a sua subscrição atual. Se não estiver a trabalhar com a subscrição da sua preferência, altere a sua subscrição usando az account set. Aqui está um exemplo de código a ser usado:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Saída do console para az account show comando:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Saiba mais sobre grupos de recursos

Um grupo de recursos é um contêiner para recursos do Azure. Para criar um grupo de recursos, você precisa de contributor permissões ou superiores em sua assinatura.

Criar um grupo de recursos

Dentro de uma assinatura, um nome de grupo de recursos deve ser exclusivo. Primeiro, verifique se o nome desejado está disponível usando o comando az group exists . Um valor de saída de false significa que o nome está disponível.
```
az group exists --name <myUniqueRGname>
```
Recupere uma lista de regiões suportadas para sua assinatura com o comando az account list-locations . Para obter uma lista de locais do Azure disponíveis, consulte Escolher a região do Azure certa para você.
```
az account list-locations --query "[].{Region:name}" --output table
```
É hora de criar seu grupo de recursos. Utilize o comando az group create.
```
az group create --___location <myLocation> --name <myUniqueRGname>
```

Criar um grupo de recursos contendo uma ID aleatória

Ao testar, é melhor criar um grupo de recursos que contenha uma ID aleatória em seu nome. Adicionar uma ID aleatória ao nome do seu grupo de recursos permite que você teste novamente seu código sem ter que esperar que um grupo de recursos anterior com o mesmo nome seja removido do Azure.

A sintaxe das variáveis Bash e PowerShell é diferente. Copie o script correto para seu ambiente.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
___location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --___location $___location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$___location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --___location $___location --output json

Saída de console do Bash e do PowerShell:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "___location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Definir variáveis de ambiente

A CLI do Azure oferece várias opções para permitir que você reutilize valores de parâmetros comuns. Esses valores padrão são armazenados em variáveis de ambiente e são exclusivos para cada entrada.

Defina seu grupo de recursos padrão.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Defina várias variáveis de ambiente ao mesmo tempo.

Muitos parâmetros da CLI do Azure usam vários valores separados por um espaço. Os valores de configuração são uma dessas instâncias. O próximo exemplo define .___location e .group como padrões usados pelos parâmetros --___location e --resource-group de cada comando da CLI do Azure.
```
az config set defaults.___location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Defina sua saída padrão.

Quando você escolhe trabalhar no Azure Cloud Shell ou instalar a CLI do Azure localmente, a saída padrão é definida automaticamente como json. No entanto, essa configuração é um dos padrões mais importantes para entender e definir. A saída determina o que aparece no console e o que está gravado no arquivo de log. Use sempre uma saída de none quando estiver criando recursos que retornem chaves, senhas e segredos.
```
az config set core.output=none
```
Neste tutorial, não estamos trabalhando com segredos. Defina o padrão de volta para json que você possa ver a saída retornada de cada comando de referência neste tutorial.
```
az config set core.output=json
```

Aprenda a usar az inito .

A CLI do Azure tem um comando de referência que o orienta na configuração do seu ambiente. Digite az init no console e pressione Enter. Siga as instruções fornecidas.

az init

Um aspeto importante do az init é que ele exibe todas as suas configurações atuais. Eis um exemplo do resultado:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing its number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk-through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Localize e leia seu arquivo de configuração.

Se você trabalha sob uma mentalidade de "confiar, mas verificar", você quer saber onde seus arquivos de configuração estão armazenados e o que eles contêm. O próprio ficheiro de configuração está localizado em $AZURE_CONFIG_DIR/config. O valor predefinido de AZURE_CONFIG_DIR é $HOME/.azure em Linux e macOS, e %USERPROFILE%\.azure no Windows. Localize o arquivo de configuração e revise seu conteúdo.

Obtenha mais detalhes

Quer mais detalhes sobre um dos assuntos abordados nesta etapa do tutorial? Use os links nesta tabela para saber mais.

Assunto	Mais informações
Ambientes	Escolher a ferramenta de linha de comandos do Azure correta
Opções de login	Entrar com a CLI do Azure
Termos	Terminologia e níveis de suporte da CLI do Azure
Subscrições	Gerenciar assinaturas usando a CLI do Azure
Grupos de recursos	Gerenciar grupos de recursos usando a CLI do Azure
Configurações	Configurar a CLI do Azure
Funções do Azure	Funções do Azure, funções do Microsoft Entra e funções clássicas de administrador de assinatura

Próximo Passo

Agora que você aprendeu como configurar seu ambiente, prossiga para a próxima etapa para entender as diferenças de script entre Bash, PowerShell e Cmd.exe.

Saiba mais sobre as diferenças de sintaxe da CLI do Azure em Bash, PowerShell e Cmd