Instalar a CLI do Azure no Windows
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 MSI, que fornece acesso à CLI por meio do prompt de comando do Windows (CMD) 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 é a 2.52.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 distribuível é usado 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.
Ú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".
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
Para download do instalador MSI de uma versão específica, altere o segmento da versão na 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) e faça o download.
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.
Executar a CLI do Azure
Agora, você pode executar a CLI do Azure com o comando az no Prompt de Comando do Windows ou no PowerShell.
Habilitar o preenchimento de tabulação no PowerShell
O PowerShell 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 concluídos pressionando a tecla Tab.
Observação
A CLI do Azure versão 2.49 ou superior é necessária para habilitar a conclusão da guia para a CLI do Azure no PowerShell.
Para habilitar o preenchimento com tabulação no PowerShell, crie ou edite 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.
Em seguida, 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.
Solução de problemas
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.
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/
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 > Sistema > Aplicativos & 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, faça um breve tour pelos recursos e comandos mais comuns dela.