Instalar a CLI do Azure no Windows

Artigo
11/14/2024

A CLI (Interface de Linha de Comando) do Azure é uma ferramenta de linha de comando de plataforma cruzada que pode ser instalada localmente em computadores Windows. Você pode usar a CLI do Azure para Windows para se conectar ao Azure e executar comandos administrativos nos recursos do Azure. A CLI do Azure para Windows também pode ser usada de um navegador por meio do Azure Cloud Shell ou 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 dá acesso à CLI por meio do Prompt de Comando do Windows (CMD) ou PowerShell. Quando você executa uma instalação para o Windows Subsystem for Linux (WSL), os pacotes estão disponíveis para 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 da CLI do Azure é 2.68.0. Para obter informações sobre a versão mais recente, veja as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, 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.

WinGet (Gerenciador de Pacotes do Windows)

Use WinGet, o 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.

Nota

WinGet está disponível por padrão no Windows 11 e versões modernas do Windows 10. No entanto, ele não pode ser 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 -e opção é garantir que o pacote oficial da CLI do Azure esteja instalado. Este comando instala a versão mais recente por padrão. Para especificar uma versão, adicione uma -v <version> com a versão desejada ao comando. Aqui está um exemplo:

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

Instalador da Microsoft (MSI)

Versão mais recente

Baixe e instale a versão mais recente da CLI do Azure. Quando o instalador perguntar se pode fazer alterações no 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ê tiver instalado anteriormente a CLI do Azure, a execução do MSI de 32 bits ou de 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 uma URL.

Para baixar o instalador MSI para uma versão específica, altere o segmento de versão em 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 CLI do Azure versão 2.51.0, sua 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 nas notas de versão da CLI do Azure. O MSI de 64 bits está disponível a partir da versão 2.51.0.

Microsoft Installer (MSI) com 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 baixará e instalará o instalador de 32 bits mais recente da CLI do Azure para Windows. Se preferir uma instalação de 64 bits, altere o 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 pelo URL descrito na próxima seção. Aqui está um exemplo de como usar o 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 nas notas de 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 Bash e 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 Bash e PowerShell. Analise estes artigos para evitar erros de script:

Considerações para executar a CLI do Azure em uma linguagem de script do PowerShell
Usar aspas nos parâmetros da CLI do Azure
Compare a sintaxe de Bash, PowerShell e Cmd.exe no Aprenda as diferenças de sintaxe da CLI do Azure em 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 a conclusão de guias. Consulte estes artigos para obter mais informações:

Pacote ZIP

Importante

Este pacote está atualmente em pré-visualização.

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

Descompacte o pacote para 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 environment variables. Clique em 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 o terminal. Agora você deve ser capaz de executar az comandos.

Versão mais recente

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 uma URL.

Para baixar o pacote ZIP para uma versão específica, altere o segmento de versão no 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 nas notas de versão da CLI do Azure. O pacote ZIP está disponível a partir da versão 2.57.0. Apenas 64 bits estão disponíveis.

Executar a CLI do Azure

Após a instalação, feche e reabra qualquer janela ativa do terminal. Execute a CLI do Azure com o comando az do Prompt de Comando do Windows ou do PowerShell. 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 vistos ao instalar a CLI do Azure no Windows. Se você tiver um problema não abordado aqui, registre um problema no GitHub.

Variável PATH não definida

A causa mais comum desse problema é que a janela de terminal ativa não foi reiniciada 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 corretamente configurado. Para o Settings > Network & Internet > Proxy Windows 10, essas configurações são gerenciadas no painel. Entre em contato com o administrador do sistema para obter as configurações necessárias ou para situações em que sua máquina pode ser gerenciada por configuração ou exigir configuração avançada.

Importante

Essas configurações também são necessárias para poder acessar os serviços do Azure com a CLI, tanto do PowerShell quanto do Prompt de Comando. No PowerShell, você faz isso com o seguinte comando:

(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 obter mais informações, consulte Trabalhar atrá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 conclusão de guia no PowerShell

O preenchimento de guias, também conhecido como "Concluídores da CLI do Azure", fornece conclusão de entradas para fornecer dicas, habilitar a descoberta e acelerar a entrada de entrada. 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 conclusão da guia é habilitada 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 guias para a CLI do Azure no PowerShell. Siga estes passos:

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.

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

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 de 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, que é recomendada para um melhor desempenho.

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

Verifique a versão atual da CLI e as extensões instaladas executando az --version.
As extensões terão de ser reinstaladas. Recomenda-se executar um backup da pasta %userprofile%\.azure\cliextensions de extensão atual, renomeando-a no caso de você optar por reverter para 32 bits. Esta pasta é criada automaticamente quando reinstala uma extensão.
Transfira e instale o instalador de 64 bits mais recente, conforme descrito em Instalar ou atualizar. O MSI de 32 bits será desinstalado automaticamente.
Instale extensões executando az extension add --name <extension> --version <version>o . Se você não quiser reinstalar extensões manualmente, a CLI do Azure solicitará que você instale uma extensão na 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 o MSI de 64 bits e reinstalar o MSI de 32 bits. Se você tiver feito um backup de sua pasta de extensão de 32 bits, restaure (renomeie) sua pasta de extensão após a alteração.

Desinstale o .

Se optar por desinstalar a CLI do Azure, é com muita pena que o vemos ir embora. Antes de desinstalar, utilize o comando az feedback para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure liver de erros e intuitiva para o utilizador. Se encontrou um erro, pedimos que registe um problema no GitHub.

Você desinstala a CLI do Azure da lista "Aplicativos e recursos" do Windows. Para desinstalar:

Plataforma	Instruções
Windows 11	Iniciar > configurações > Aplicativos > instalados
Windows 10	Iniciar > Definições > Aplicações > Aplicações & Funcionalidades
Windows 8 e Windows 7	Iniciar > programas > do painel > de controle Desinstalar um programa

Uma vez nesta 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 Uninstall botão.

Remover dados

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

Passos Seguintes

Agora que você instalou a CLI do Azure no Windows, saiba mais sobre as diferentes maneiras de entrar.

Entrar com a CLI do Azure

Partilhar via

Instalar a CLI do Azure no Windows

Instalar ou atualizar

WinGet (Gerenciador de Pacotes do Windows)

Instalador da Microsoft (MSI)

Versão mais recente

Versão específica

Microsoft Installer (MSI) com PowerShell

Versão específica

Diferenças de sintaxe entre Bash e PowerShell

Pacote ZIP

Versão mais recente

Versão específica

Executar a CLI do Azure

Solução de problemas de instalação

Variável PATH não definida

O proxy bloqueia a ligação

Tempos de resposta lentos

Habilitar conclusão de guia no PowerShell

Atualizar a CLI do Azure

Migrar para a CLI do Azure de 64 bits

Desinstale o .

Remover dados

Passos Seguintes

Recursos adicionais