Instalar o CLI do Azure 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 CLI do Azure para Windows para se conectar a Azure e executar comandos administrativos em Azure recursos. O CLI do Azure 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 CLI do Azure é instalado por meio de um pacote MSI ou ZIP, que fornece acesso ao CLI do Azure por meio do PowerShell ou do prompt de comando Windows (cmd.exe). Quando você executa uma instalação para Subsistema do Windows para 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 CLI do Azure é 2.85.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

As distribuições MSI e ZIP são usadas para instalar ou atualizar o CLI do Azure no Microsoft 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 CLI do Azure

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

Antes de executar comandos do CLI do Azure, é necessário fazer login no Azure. Para entrar interativamente, use az login. Para obter informações sobre autenticação, consulte Entre no Azure com 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 CLI do Azure 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 CLI do Azure.

Tempos de resposta lentos

Consulte Migração para a CLI do Azure de 64 bits

Habilitar a autocompletação de comandos no PowerShell

A conclusão da guia, também conhecida como "completadores de CLI do Azure", fornece a conclusão de entradas para fornecer dicas, habilitar a descoberta e acelerar a entrada de entrada. 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 conclusão da guia é habilitada por padrão em Azure Cloud Shell e na maioria das distribuições do Linux. A partir do CLI do Azure versão 2.49, você pode habilitar a conclusão da guia para o CLI do Azure 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 CLI do Azure

Começando com a versão 2.11.0, o CLI do Azure 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 CLI do Azure anteriores a 2.11.0, atualize reinstalando conforme descrito em Instale o CLI do Azure.

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 CLI do Azure de 64 bits

A partir da 2.51.0, CLI do Azure 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 CLI do Azure:

1. Verifique a versão do CLI do Azure 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 CLI do Azure 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 CLI do Azure, 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 CLI do Azure sem bugs e amigável. Se você encontrou um bug, gostaríamos que file um problema de GitHub.

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

Uma vez nessa tela, digite CLI do Azure na barra de pesquisa do programa. O programa a ser desinstalado é 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 CLI do Azure, 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 CLI do Azure em Windows, saiba mais sobre as diferentes maneiras de entrar.