Instalar a CLI do Azure no Windows

A Interface de Command-Line do Azure (CLI) é uma ferramenta de linha de comandos de várias plataformas que pode ser instalada localmente em computadores Windows. Pode utilizar a CLI do Azure para Windows para ligar ao Azure e executar comandos administrativos em recursos do Azure. A CLI do Azure para Windows também pode ser utilizada a partir de um browser através do Azure Cloud Shell ou executada a partir de um contentor do Docker.

Para o Windows, a CLI do Azure é instalada através de um MSI, que lhe dá acesso à CLI através da Linha de Comandos do Windows (CMD) ou do PowerShell. Quando efetuar a instalação para o Subsistema do Windows para Linux (WSL), existem pacotes disponíveis para a sua distribuição do 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 é a 2.44.0. Para obter informações sobre a versão mais recente, veja as notas de versão. Para localizar a sua versão instalada e ver se precisa de atualizar, execute az version.

Instalar ou atualizar

O MSI distributable é utilizado para instalar ou atualizar a CLI do Azure no Windows. Não precisa de desinstalar as versões atuais antes de utilizar o instalador MSI porque o MSI irá atualizar qualquer versão existente.

Nota

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

Versão mais recente

Transfira e instale a versão mais recente da CLI do Azure. Quando o instalador pedir se pode efetuar alterações ao seu computador, clique na caixa "Sim".

Versão específica

Para transferir o instalador MSI para uma versão específica, altere o segmento de versão no URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi e transfira-o. As versões disponíveis podem ser encontradas nas notas de versão da CLI do Azure.

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.

Resolução de problemas

Seguem-se alguns problemas comuns vistos ao instalar a CLI do Azure no Windows. Se tiver um problema não abordado aqui, submeta 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 configurado corretamente. Para Windows 10, estas definições são geridas no Settings > Network & Internet > Proxy painel. Contacte o administrador de sistema para obter as definições necessárias ou para situações em que o computador possa ser gerido pela configuração ou exigir uma configuração avançada.

Importante

Estas definições também são necessárias para poder aceder aos serviços do Azure com a CLI, tanto a partir do PowerShell como da Linha de Comandos. No PowerShell, pode fazê-lo com o seguinte comando:

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

Para obter o MSI, o proxy tem de permitir ligações HTTPS aos seguintes endereços:

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

Desinstalar

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.

Desinstale a CLI do Azure a partir da lista "Aplicações e Funcionalidades" do Windows. Para desinstalar:

Plataforma Instruções
Windows 11 Iniciar > Definições > Aplicações > Instaladas
Windows 10 Funcionalidades das Aplicações & do Sistema > de Definições > de Início >
Windows 8 e Windows 7 Iniciar > programas de Painel de Controlo > 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 o Azure. Selecione esta aplicação e, em seguida, clique no Uninstall botão.

Remover dados

Se não planear reinstalar a CLI do Azure, remova os respetivos dados de C:\Users\<username>\.azure\msal_token_cache.bin ou C:\Users\<username>\.azure\msal_token_cache.json.

Passos Seguintes

Agora que instalou a CLI do Azure no Windows, faça uma breve apresentação das funcionalidades e comandos comuns.