Instalar o Azure CLI no Windows

A CLI (Interface Azure Command-Line) é uma ferramenta de linha de comando multiplataforma que pode ser instalada localmente em computadores Windows. Você pode usar o Azure CLI para Windows para se conectar a Azure e executar comandos administrativos em Azure recursos. O Azure CLI também pode ser usado de um navegador por meio do Azure Cloud Shell ou executado de dentro de um contêiner do Docker.

Para Windows, o Azure CLI é instalado por meio de um pacote MSI ou ZIP, que fornece acesso ao Azure CLI por meio do PowerShell ou do prompt de comando Windows (cmd.exe). Quando você executa uma instalação para Windows Subsystem for Linux (WSL), os pacotes ficam disponíveis para sua distribuição do Linux. Consulte a página instalação principal para ver a lista de gerenciadores de pacotes com suporte ou como instalar manualmente no WSL.

A versão atual do Azure CLI é 2.84.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Instalar ou atualizar

O MSI e o ZIP distribuíveis 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

Executar o Azure CLI

Após a instalação, feche e reabra qualquer janela do terminal ativo. Execute o Azure CLI com o comando az do PowerShell ou do prompt de comando Windows.

Antes de executar comandos do Azure CLI, você deve fazer login no Azure. Para entrar interativamente, use az login. Para obter informações sobre autenticação, consulte Entrar no Azure com a CLI do Azure.

az login

Uma primeira etapa comum é verificar sua assinatura ativa.

az account show

Como solucionar problemas de instalação

Aqui estão alguns problemas comuns vistos ao instalar o Azure CLI no Windows. Se você tiver um problema não abordado aqui, file um problema em 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 de terminal ativa.

Proxy bloqueia conexão

Se você não conseguir baixar o instalador msi porque o proxy está bloqueando a conexão, verifique se você tem seu proxy configurado. Para Windows 11, essas configurações são gerenciadas no painel Settings > Network & Internet > Proxy. Entre em contato com o administrador do sistema para obter as configurações necessárias ou para situações em que seu computador possa ser gerenciado por configuração ou exigir configuração avançada.

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

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

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

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

Tempos de resposta lentos

Consulte Migrar para o Azure CLI de 64 bits

Habilitar a autocompletação de comandos no PowerShell

O recurso de autocompletar, também conhecido como "completers do Azure CLI", fornece a conclusão de entradas para oferecer sugestões, habilitar a descoberta e acelerar a entrada de dados. Nomes de comando, nomes de grupo de comandos, parâmetros e determinados valores de parâmetro podem ser inseridos automaticamente na linha de comando pressionando a tecla Tab.

A funcionalidade de autocompletar com a tecla Tab é habilitada por padrão no Azure Cloud Shell e na maioria das distribuições Linux. A partir do Azure CLI versão 2.49, você pode habilitar a conclusão automática para o Azure CLI no PowerShell. Siga estas etapas:

1. Criar ou editar o perfil armazenado na variável $PROFILE. A maneira mais simples é executar notepad $PROFILE no PowerShell. Para obter mais informações, confira 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.

Atualizar o Azure CLI

Começando com a versão 2.11.0, o Azure CLI fornece um comando na ferramenta para atualizar para a versão mais recente.

az upgrade

Esse comando também atualiza todas as extensões instaladas por padrão. Para obter mais opções de az upgrade, confira a página de referência do comando. Para versões Azure CLI 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, Azure CLI também fornece uma MSI de 64 bits, que é recomendada para um melhor desempenho.

Siga estas etapas para migrar para a versão de 64 bits do Azure CLI:

1. Verifique a versão do Azure CLI atual e as extensões instaladas executando az --version.
2. As extensões exigem 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. Essa pasta é criada automaticamente ao reinstalar uma extensão.
3. Baixe e instale o instalador de 64 bits mais recente, conforme descrito em Instalar ou atualizar. O MSI de 32 bits é desinstalado automaticamente.
4. Instale as extensões executando az extension add --name <extension> --version <version>. Se você não quiser reinstalar as extensões manualmente, o Azure CLI solicitará que você instale uma extensão no primeiro uso. Para obter mais informações sobre a instalação de extensões, confira Como instalar extensões.

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

Desinstalar

Se você decidir desinstalar o Azure CLI, lamentamos vê-lo partir. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é tornar o Azure CLI sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de GitHub.

Desinstale o Azure CLI da lista "Aplicativos e Recursos" Windows. Para desinstalar:

Uma vez nessa tela, digite Azure CLI na barra de pesquisa do programa. O programa a ser desinstalado está listado como Microsoft CLI 2.0 para Azure. Selecione este aplicativo e, em seguida, selecione o botão Uninstall.

Remova dados

Se você não planeja reinstalar Azure CLI, remova seus dados de C:\Users\<username>\.azure\msal_token_cache.bin ou C:\Users\<username>\.azure\msal_token_cache.json.

Próximas etapas

Agora que você instalou o Azure CLI em Windows, saiba mais sobre as diferentes maneiras de entrar.