Partilhar via


Instalar a CLI do Azure no Windows

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

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

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.

Executar a CLI do Azure

Agora, pode executar a CLI do Azure com o comando az a partir da Linha de Comandos do Windows ou do PowerShell.

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:

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

  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.

Resolução de Problemas

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.

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/

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:

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

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.

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.