Partilhar via

Instale a CLI do Azure no Windows

A Interface Azure Command-Line (CLI) é uma ferramenta de linha de comandos multiplataforma que pode ser instalada localmente em Windows computadores. Pode usar a CLI do Azure para Windows para se ligar ao Azure e executar comandos administrativos nos recursos do Azure. A CLI do Azure também pode ser usada a partir de um navegador através do Azure Cloud Shell ou executada dentro de um contentor Docker.

Para Windows, o CLI do Azure é instalado por meio de um MSI ou de um pacote ZIP, que lhe dá acesso ao CLI do Azure por meio do PowerShell ou do Prompt de Comando do Windows (cmd.exe). Quando realiza uma instalação para Subsistema Windows para Linux (WSL), estão disponíveis pacotes para a 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 do CLI do Azure é 2.84.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Instalar ou atualizar

Os distribuíveis ZIP e MSI 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 instalação estar concluída, deve fechar e reabrir qualquer janela de terminal ativa para usar o CLI do Azure.

WinGet (Windows Gestor de Pacotes)

Use WinGet, o gestor de pacotes da Microsoft para Windows, para instalar e gerir atualizações para CLI do Azure. Por defeito, o Winget instala o CLI do Azure de 64 bits em sistemas operativos a 64 bits.

Observação

O WinGet está disponível como padrão no Windows 11 e nas versões modernas do Windows 10. No entanto, 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 --exact --id Microsoft.AzureCLI

A opção --exact é garantir que o pacote oficial de CLI do Azure está instalado. Este comando instala a versão mais recente por padrão. Para especificar uma versão, adicione uma com a versão desejada ao comando. Aqui está um exemplo:

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

Instalador da Microsoft (MSI)

Versão mais recente

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

Último MSI do CLI do Azure (32 bits)

Mais recente MSI do CLI do Azure (64-bit)

Se já instalou previamente a CLI do Azure, executar o MSI de 32 bits ou de 64 bits irá sobrescrever uma instalação existente.

Versão específica

Se preferires, podes descarregar uma versão específica da CLI do Azure usando um URL.

Para baixar o instalador MSI para uma versão específica, altere o segmento de versão em URL (32 bits) ou (64 bits).

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

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

Microsoft Installer (MSI) com PowerShell

Para instalar o CLI do Azure usando o PowerShell, inicie o PowerShell as administrator 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

Isto irá descarregar e instalar o mais recente instalador de 32 bits da CLI do Azure para Windows. Se preferir uma instalação de 64 bits, altere o URL para . Se a CLI do Azure já estiver instalada, o instalador irá sobrescrever a versão existente.

Para instalar uma versão específica, substitua o argumento pelo URL descrito na próxima seção. Aqui está um exemplo de utilização do instalador de 32 bits da versão CLI do Azure 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

Para baixar o instalador MSI para uma versão específica, altere o segmento de versão em URL (32 bits) ou (64 bits).

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

As versões CLI do Azure disponíveis podem ser encontradas em CLI do Azure notas de lançamento. 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 maior parte da documentação da CLI do Azure seja escrita e testada numa shell Bash, 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:

Ao executar a CLI do Azure no PowerShell, existem também diferenças no tratamento de erros e a possibilidade de ativar a conclusão de tabulação. Consulte estes artigos para obter mais informações:

Pacote ZIP

Importante

Este pacote está atualmente em pré-lançamento.

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

Descompacta o pacote numa pasta e, usando o Cmd ou PowerShell, chama o CLI do Azure executando <unzipped folder path>\bin\az.cmd.

Se quiseres executar o comando az diretamente, segue os passos abaixo para adicionar o CLI do Azure à tua variável de ambiente PATH.

  1. Abra o Menu Iniciar e procure . Clique em .
  2. Clique no botão .
  3. Na caixa , selecione e clique no botão .
  4. Clique no botão e adicione o à lista.
  5. Reinicie o terminal. Agora você deve ser capaz de executar comandos.

Versão mais recente

ZIP mais recente do CLI do Azure (64 bits)

Versão específica

Se preferires, podes descarregar uma versão específica da CLI do Azure usando um URL.

Para baixar o pacote ZIP para uma versão específica, altere o segmento de versão no URL .

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

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

Execute o CLI do Azure

Após a instalação, feche e reabra qualquer janela ativa do terminal. Executa o CLI do Azure com o comando az a partir do PowerShell ou do Prompt de Comando Windows.

Antes de poder executar comandos CLI do Azure, deve iniciar sessão no Azure. Para iniciar sessão interativamente, utilize . Para informações sobre autenticação, consulte Iniciar sessão em Azure com CLI do Azure.

az login

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 ao instalar a CLI do Azure no Windows. Se tiver um problema não abordado aqui, apresenta uma reclamação no 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 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 configurado. Para Windows 11, estas definições são geridas no painel Settings > Network & Internet > Proxy. Entre em contato com o administrador do sistema para obter as configurações necessárias ou situações em que sua máquina possa ser gerenciada por configuração ou exigir configuração avançada.

Importante

Estas definições também são necessárias para conseguir aceder aos serviços do Azure com a CLI do Azure, seja a partir do PowerShell ou do Prompt de Comandos. No PowerShell, você executa essa configuração 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 mais informações, consulte Trabalhar atrás de um proxy no guia de resolução de problemas do CLI do Azure.

Tempos de resposta lentos

Ver Migrar para a CLI do Azure de 64 bits

Habilitar a conclusão da guia no PowerShell

A completação de tabulação, também conhecida como "completadores do CLI do Azure", proporciona a conclusão das entradas para fornecer dicas, facilitar a descoberta e acelerar a introdução. 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 automática com tab está ativada por padrão no Azure Cloud Shell e na maioria das distribuições Linux. A partir do CLI do Azure versão 2.49, pode ativar a conclusão de tabulação para a CLI do Azure no PowerShell. Siga estes passos:

  1. Crie ou edite o perfil armazenado na variável . A maneira mais simples é executar 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 ao seu perfil do PowerShell.

Atualize a CLI do Azure

A partir da versão 2.11.0, o 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 opções, consulte a página de referência do comando. Para CLI do Azure versões 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, a CLI do Azure também fornece um MSI de 64 bits, recomendado para melhor desempenho.

Siga estes passos para migrar para a versão de 64 bits do CLI do Azure:

  1. Verifique a sua versão CLI do Azure atual e as extensões instaladas correndo az --version.
  2. As extensões requerem reinstalação. Faça backup da pasta de extensão atual renomeando-a caso decida reverter para a versão de 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 é desinstalado automaticamente.
  4. Instale extensões executando . Se não quiseres reinstalar extensões manualmente, a interface do CLI do Azure pede-te para instalar uma extensão à 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 a versão de 64 bits e reinstalar o MSI de 32 bits. Se você fez um backup de sua pasta de extensões de 32 bits, restaure ou renomeie sua pasta de extensão após a alteração.

Desinstale

Se decidires desinstalar a CLI do Azure, lamentamos ver-te embora. Antes de desinstalar, utilize o comando para nos indicar o que é possível melhorar ou corrigir. O nosso objetivo é tornar a CLI do Azure livre de bugs e fácil de usar. Se encontraram um bug, agradeceríamos que apresentassem uma GitHub questão.

Desinstalas a interface do CLI do Azure da lista "Apps and Features" do Windows. Para desinstalar:

Plataforma Instruções
Windows 11 Iniciar Definições Aplicações Aplicações instaladas
Windows 10 Iniciar Definições Aplicações Aplicações & Funcionalidades
Windows 8 e Windows 7 Iniciar > Painel de Controlo > Programas > Desinstalar um programa

Uma vez neste ecrã, escreva CLI do Azure na barra de pesquisa do programa. O programa para desinstalar está listado como Microsoft CLI 2.0 para Azure. Selecione este aplicativo e, em seguida, selecione o botão.

Remover os dados

Se não planeias reinstalar CLI do Azure, remove os dados dela de C:\Users\<username>\.azure\msal_token_cache.bin ou C:\Users\<username>\.azure\msal_token_cache.json.

Próximas Etapas

Agora que instalou a CLI do Azure no Windows, aprenda sobre as diferentes formas de iniciar sessão.

Iniciar sessão com CLI do Azure

  • Last updated on