Instalar a CLI do Azure no Windows

  • Artigo

A CLI (Interface de Linha de Comando) do Azure é uma ferramenta de linha de comando de multiplataforma que pode ser instalada localmente em computadores Windows. Você pode usar a CLI do Azure para Windows a fim de se conectar ao Azure e executar comandos administrativos sobre os recursos do Azure. A CLI do Azure para Windows também pode ser usada em um navegador por meio do Azure Cloud Shell ou pode ser executada de dentro de um contêiner do Docker.

Para o Windows, a CLI do Azure é instalada por meio de um pacote MSI ou ZIP, que fornece acesso à CLI por meio do CMD (Prompt de Comando do Windows) ou do PowerShell. Quando você executa uma instalação para o 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 da CLI do Azure é 2.59.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 a CLI do Azure 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.

Importante

Após a conclusão da instalação, você precisará fechar e reabrir qualquer janela de terminal ativa para usar a CLI do Azure.

Última versão

Baixe e instale a última versão da CLI do Azure. Quando o instalador perguntar se pode fazer alterações em seu computador, selecione a caixa "Sim".

MSI mais recente da CLI do Azure (32 bits)

MSI mais recente da CLI do Azure (64 bits)

Se você instalou a CLI do Azure anteriormente, a execução do MSI de 32 bits ou 64 bits substituirá uma instalação existente.

Versão específica

Se preferir, você pode baixar uma versão específica da CLI do Azure usando um URL.

Para baixar o instalador MSI de uma versão específica, altere o segmento da versão no URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 bits) ou https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bits).

Por exemplo, para instalar o MSI de 32 bits da versão 2.51.0 da CLI do Azure, a URL seria https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. A instalação de 64 bits correspondente seria https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

As versões disponíveis da CLI do Azure podem ser encontradas em Notas sobre a versão da CLI do Azure. O MSI de 64 bits está disponível a partir da versão 2.51.0.

Executar a CLI do Azure

Agora, você pode executar a CLI do Azure com o comando az no Prompt de Comando do Windows ou no PowerShell.

Habilitar o preenchimento de tabulação no PowerShell

Preenchimento de tabulação, também conhecido como "preenchedores da CLI do Azure" fornece preenchimento de entradas para fornecer dicas, habilitar a descoberta e acelerar a entrada de informações. 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.

O recurso de preenchimento de tabulação está disponível por padrão no Azure Cloud Shell e na maioria das distribuições Linux. A partir da CLI do Azure versão 2.49, você pode habilitar o preenchimento de tabulação para a 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.

Solução de problemas

Estes são alguns problemas comuns observados ao instalar a CLI do Azure no Windows. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.

Conexão de blocos de proxy

Se não for possível baixar o instalador do MSI porque o proxy está bloqueando a conexão, verifique se o proxy foi configurado corretamente. No Windows 10, essas configurações são gerenciadas no painel Settings > Network & Internet > Proxy. Entre em contato com o administrador do sistema para saber as configurações exigidas ou em situações em que o computador pode ser gerenciado por configuração ou precise de configurações avançadas.

Importante

Essas configurações também precisam ser capazes de acessar os serviços do Azure com a CLI, tanto do PowerShell quanto do prompt de comando. No PowerShell, faça isso com o seguinte comando:

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

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

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

Migrar para a CLI do Azure de 64 bits

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

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

  1. Verifique sua versão atual da CLI e as extensões instaladas executando az --version.
  2. As extensões precisarão ser reinstaladas. É recomendável fazer um backup da pasta de extensão atual %userprofile%\.azure\cliextensions, renomeando-a, caso você decida voltar para 32 bits. Essa pasta é criada automaticamente ao reinstalar uma extensão.
  3. Faça o download e instale o instalador de 64 bits mais recente, conforme descrito em Instalar ou atualizar. O MSI de 32 bits será 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, a 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 o MSI de 64 bits e reinstalar o de 32 bits. Se você tiver feito um backup da pasta de extensão de 32 bits, restaure (renomeie) a pasta de extensão após a alteração.

Atualizar a CLI do Azure

A partir da versão 2.11.0, a 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 da CLI do Azure anteriores à 2.11.0, atualize reinstalando conforme descrito em Instalar a CLI do Azure.

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

Desinstalar

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.

Desinstale a CLI do Azure da lista de "Aplicativos e recursos" do Windows. Para desinstalar:

Plataforma Instruções
Windows 11 Iniciar > Configurações > Aplicativos > Aplicativos instalados
Windows 10 Iniciar > Configurações > Sistema > Aplicativos e Recursos
Windows 8 e Windows 7 Iniciar > Painel de Controle > Programas > Desinstalar um programa

Uma vez nessa tela, digite CLI do Azure na barra de pesquisa do programa. O programa de desinstalação aparece como Microsoft CLI 2.0 para Azure. Selecione este aplicativo e, em seguida, selecione o botão Uninstall.

Remover dados

Se você não planeja reinstalar a CLI do Azure, remova os respectivos 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 a CLI do Azure no Windows, saiba mais sobre as diferentes maneiras de entrar.

Entrar com a CLI do Azure