Instale a CLI do Azure no Windows

A Interface Azure Command-Line (CLI) é uma ferramenta de linha de comandos multiplataforma que pode ser instalada localmente em Windows computadores. Pode usar a Azure CLI para Windows para se ligar ao Azure e executar comandos administrativos nos recursos do Azure. A Azure CLI também pode ser usada a partir de um navegador através do Azure Cloud Shell ou executada dentro de um contentor Docker.

Para Windows, o Azure CLI é instalado através de um MSI ou de um pacote ZIP, que lhe dá acesso ao Azure CLI através do PowerShell ou do Prompt de Comando do Windows (cmd.exe). Quando realiza uma instalação para Windows Subsystem for Linux (WSL), estão disponíveis pacotes para a sua distribuição Linux. Veja a página de instalação principal da lista de gestores de pacotes suportados ou como instalar manualmente no WSL.

A versão atual do Azure CLI é 2.84.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.

Instalar ou atualizar

Os distribuíveis MSI e ZIP são usados para instalar ou atualizar o Azure CLI no Windows. Você não precisa desinstalar as versões atuais antes de usar o instalador MSI porque o MSI atualiza qualquer versão existente.

winget install --exact --id Microsoft.AzureCLI

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

Execute o Azure CLI

Após a instalação, feche e reabra qualquer janela ativa do terminal. Executa o Azure CLI com o comando az a partir do PowerShell ou do Prompt de Comando Windows.

Antes de poder executar comandos Azure CLI, deve iniciar sessão no Azure. Para iniciar sessão interativamente, utilize az login. Para informações sobre autenticação, consulte Iniciar sessão em Azure com Azure CLI.

az login

Um primeiro passo comum é verificar a sua subscrição ativa.

az account show

Solução de problemas de instalação

Aqui estão alguns problemas comuns ao instalar a Azure CLI no Windows. Se tiver um problema não abordado aqui, apresenta uma reclamação no GitHub.

Variável PATH não definida

A causa mais comum desse problema é não reiniciar a janela do terminal ativo após a instalação. Feche e reabra qualquer janela ativa do terminal.

O proxy bloqueia a ligação

Se não conseguir transferir o instalador MSI porque o proxy está a bloquear a ligação, certifique-se de que tem o proxy configurado. Para Windows 11, estas definições são geridas no painel Settings > Network & Internet > Proxy. Entre em contato com o administrador do sistema para obter as configurações necessárias ou situações em que sua máquina possa ser gerenciada por configuração ou exigir configuração avançada.

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Para obter o MSI, seu proxy precisa permitir conexões HTTPS para os seguintes endereços:

• https://aka.ms/
• https://azcliprod.blob.core.windows.net/

Para mais informações, consulte Trabalhar atrás de um proxy no guia de resolução de problemas do Azure CLI.

Tempos de resposta lentos

Ver Migrar para CLI de Azure de 64 bits

Habilitar a conclusão da guia no PowerShell

A completação de tabulação, também conhecida como "completadores do Azure CLI", oferece a conclusão das entradas para fornecer dicas, permitir a descoberta e acelerar a entrada de dados. Nomes de comandos, nomes de grupos de comandos, parâmetros e certos valores de parâmetros podem ser inseridos automaticamente na linha de comando pressionando a tecla Tab .

A funcionalidade de autocompletar está ativada por padrão no Azure Cloud Shell e na maioria das distribuições Linux. A partir da versão 2.49 do Azure CLI, pode ativar o autocompletar com a tecla Tab para o Azure CLI no PowerShell. Siga estes passos:

1. Crie ou edite o perfil armazenado na variável $PROFILE. A maneira mais simples é executar notepad $PROFILE no PowerShell. Para obter mais informações, consulte Como criar seu perfil e Perfis e política de execução.

2. Adicione o seguinte código ao seu perfil do PowerShell:

   Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
       param($commandName, $wordToComplete, $cursorPosition)
       $completion_file = New-TemporaryFile
       $env:ARGCOMPLETE_USE_TEMPFILES = 1
       $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
       $env:COMP_LINE = $wordToComplete
       $env:COMP_POINT = $cursorPosition
       $env:_ARGCOMPLETE = 1
       $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
       $env:_ARGCOMPLETE_IFS = "`n"
       $env:_ARGCOMPLETE_SHELL = 'powershell'
       az 2>&1 | Out-Null
       Get-Content $completion_file | Sort-Object | ForEach-Object {
           [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
       }
       Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
   }
   

3. Para exibir todas as opções disponíveis no menu, adicione Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete ao seu perfil do PowerShell.

Atualize a Azure CLI

A partir da versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Este comando também atualiza todas as extensões instaladas por predefinição. Para obter mais az upgrade opções, consulte a página de referência do comando. Para Azure CLI versões anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o Azure CLI.

Se você estiver usando a distribuição ZIP, remova a pasta de instalação antiga e extraia a nova versão para o mesmo local.

Migrar para Azure CLI de 64 bits

A partir da 2.51.0, a Azure CLI também fornece um MSI de 64 bits, recomendado para melhor desempenho.

Siga estes passos para migrar para a versão de 64 bits do Azure CLI:

1. Verifique a sua versão Azure CLI atual e as extensões instaladas correndo az --version.
2. As extensões requerem reinstalação. Faça backup da pasta %userprofile%\.azure\cliextensions de extensão atual renomeando-a caso decida reverter para a versão de 32 bits. Esta pasta é criada automaticamente quando reinstala uma extensão.
3. Transfira e instale o instalador de 64 bits mais recente conforme descrito em Instalar ou atualizar. O MSI de 32 bits é desinstalado automaticamente.
4. Instale extensões executando az extension add --name <extension> --version <version>. Se não quiseres reinstalar extensões manualmente, a interface do Azure CLI pede-te para instalar uma extensão à primeira utilização. Para obter mais informações sobre como instalar extensões, consulte Como instalar extensões.

Se tiver problemas após a migração, pode desinstalar a versão de 64 bits e reinstalar o MSI de 32 bits. Se você fez um backup de sua pasta de extensões de 32 bits, restaure ou renomeie sua pasta de extensão após a alteração.

Desinstale

Se decidires desinstalar a Azure CLI, lamentamos ver-te embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a Azure CLI livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

Desinstalas a interface do Azure CLI da lista "Apps and Features" do Windows. Para desinstalar:

Uma vez neste ecrã, escreva Azure CLI na barra de pesquisa do programa. O programa para desinstalar está listado como Microsoft CLI 2.0 para Azure. Selecione este aplicativo e, em seguida, selecione o Uninstall botão.

Remover os dados

Se não planeias reinstalar Azure CLI, remove os dados dela de C:\Users\<username>\.azure\msal_token_cache.bin ou C:\Users\<username>\.azure\msal_token_cache.json.

Próximas Etapas

Agora que instalou a Azure CLI no Windows, aprenda sobre as diferentes formas de iniciar sessão.