Instalar a CLI do Azure no Windows

Artigo
08/19/2024

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 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.68.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ível 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.

WinGet (Gerenciador de Pacotes do Windows)

Use WinGet, gerenciador de pacotes da Microsoft para Windows, para instalar e gerenciar atualizações para a CLI do Azure. Por padrão, o Winget instala a CLI do Azure de 64 bits em sistemas operacionais de 64 bits.

Observação

O WinGet está disponível por padrão no Windows 11 e nas versões modernas do Windows 10. No entanto, ele pode não estar instalado em versões mais antigas do Windows. Consulte a documentação do winget para obter instruções de instalação.

winget install -e --id Microsoft.AzureCLI

A opção -e garante que o pacote oficial da CLI do Azure seja instalado. Esse comando instala a versão mais recente por padrão. Para especificar uma versão, adicione um -v <version> com a versão desejada ao comando. Veja um exemplo:

winget install -e --id Microsoft.AzureCLI -v 2.66.0

MSI (Microsoft Installer)

Ú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.

MSI (Microsoft Installer) com o PowerShell

Para instalar a CLI do Azure usando o PowerShell, inicie o PowerShell como administrador e execute o seguinte comando:

$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

Isso fará o download e instalará o instalador de 32 bits mais recente da CLI do Azure para Windows. Se preferir uma instalação de 64 bits, altere a URL para https://aka.ms/installazurecliwindowsx64. Se a CLI do Azure já estiver instalada, o instalador substituirá a versão existente.

Para instalar uma versão específica, substitua o argumento -Uri pela URL descrita na próxima seção. Veja um exemplo de uso do instalador de 32 bits da CLI do Azure versão 2.51.0 no PowerShell:

$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

Versão específica

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.

Diferenças de sintaxe entre o Bash e o PowerShell

Embora a maioria da documentação da CLI do Azure seja escrita e testada em um shell Bash, você também pode instalar e executar a CLI do Azure usando o PowerShell. Há diferenças sutis de sintaxe entre o Bash e o PowerShell. Examine estes artigos para evitar erros de script:

Considerações para executar a CLI do Azure em uma linguagem de script do PowerShell
Usar aspas em parâmetros na CLI do Azure
Comparar a sintaxe do Bash, PowerShell e Cmd.exe em Aprenda as diferenças de sintaxe da CLI do Azure no Bash, PowerShell e Cmd

Ao executar a CLI do Azure no PowerShell, também há diferenças de tratamento de erros e a capacidade de habilitar o preenchimento de tabulação. Para obter mais informações, confira estes artigos:

Pacote ZIP

Importante

O pacote está atualmente em versão prévia.

Você pode usar o pacote ZIP para instalar a CLI do Azure no Windows. Este pacote é útil quando você não tem privilégios administrativos.

Descompacte o pacote em uma pasta e, usando Cmd ou PowerShell, chame a CLI do Azure executando <unzipped folder path>\bin\az.cmd.

Se você quiser executar o az comando diretamente, siga as etapas abaixo para adicionar a CLI do Azure à sua PATH variável de ambiente.

Abra o Menu Iniciar e procure por environment variables. Clique no Edit the system environment variables.
Clique no botão Environment Variables....
User varibles for <username> Na caixa, selecione Path e clique no Edit... botão.
Clique no New botão e adicione o <unzipped folder path>\bin à lista.
Reinicie seu terminal. Agora você deve ser capaz de executar az comandos.

Última versão

ZIP mais recente da CLI do Azure (64 bits)

Versão específica

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

Para fazer download do pacote ZIP de uma versão específica, altere o segmento de versão em URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Por exemplo, para instalar o ZIP de 64 bits da CLI do Azure versão 2.57.0, sua URL seria https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

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

Executar a CLI do Azure

Após a instalação, feche e reabra qualquer janela do terminal ativo. Execute a CLI do Azure com o comando az do Prompt de Comando do Windows ou do PowerShell. Uma primeira etapa comum é verificar sua assinatura ativa.

az account show

Como solucionar problemas de instalação

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.

Variável PATH não definida

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

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/

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

Tempos de resposta lentos

Consulte Migrar para a CLI do Azure de 64 bits

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:

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.

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
}

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

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.

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:

Verifique sua versão atual da CLI e as extensões instaladas executando az --version.
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.
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.
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.

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 > Aplicativos > 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

Compartilhar via

Instalar a CLI do Azure no Windows

Instalar ou atualizar

WinGet (Gerenciador de Pacotes do Windows)

MSI (Microsoft Installer)

Última versão

Versão específica

MSI (Microsoft Installer) com o PowerShell

Versão específica

Diferenças de sintaxe entre o Bash e o PowerShell

Pacote ZIP

Última versão

Versão específica

Executar a CLI do Azure

Como solucionar problemas de instalação

Variável PATH não definida

Conexão de blocos de proxy

Tempos de resposta lentos

Habilitar o preenchimento de tabulação no PowerShell

Atualizar a CLI do Azure

Migrar para a CLI do Azure de 64 bits

Desinstalar

Remover dados

Próximas etapas

Recursos adicionais