Instalar a CLI do Azure no WindowsInstall Azure CLI on Windows

Para o Windows, a CLI do Azure é instalada por meio de um MSI, o que fornece acesso à CLI por meio do Prompt de Comando do Windows (CMD) ou o PowerShell.For Windows, the Azure CLI is installed via a MSI, which gives you access to the CLI through the Windows Command Prompt (CMD) or PowerShell. Ao instalar o Subsistema do Windows para Linux (WSL), há pacotes disponíveis para a distribuição do Linux.When installing for Windows Subsystem for Linux (WSL), packages are available for your Linux distribution. Consulte a página instalação principal para ver a lista de gerenciadores de pacotes com suporte ou como instalar manualmente no WSL.See the main install page for the list of supported package managers or how to install manually under WSL.

A versão atual da CLI do Azure é a 2.21.0.The current version of the Azure CLI is 2.21.0. Para saber mais sobre a versão mais recente, veja as notas de versão.For information about the latest release, see the release notes. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.To find your installed version and see if you need to update, run az version.

Instalar ou atualizarInstall or update

O MSI distribuível é usado para instalar ou atualizar a CLI do Azure no Windows.The MSI distributable is used for installing or updating the Azure CLI on Windows. Você não precisa desinstalar as versões atuais antes de usar o instalador MSI, pois o MSI atualizará qualquer versão existente.You don't need to uninstall current versions before using the MSI installer because the MSI will update any existing version.

Quando o instalador perguntar se pode fazer alterações no computador, clique na caixa "Sim".When the installer asks if it can make changes to your computer, click the "Yes" box.

Versão atual da CLI do AzureAzure CLI current version

Baixe e instale a versão atual da CLI do Azure.Download and install the current release of the Azure CLI. Após a conclusão da instalação, você precisará fechar e reabrir qualquer prompt de comando ativo do Windows ou janelas do PowerShell para usar a CLI do Azure.After the installation is complete, you will need to close and reopen any active Windows Command Prompt or PowerShell windows to use the Azure CLI.

Versão beta da CLI do AzureAzure CLI beta version

A versão beta da CLI do Azure dá suporte a todos os comandos e será mantida em sincronia com a versão de lançamento atual.The beta version of the Azure CLI supports all commands and will stay in sync with the current released version. Para obter instruções de instalação, confira Instalar a versão beta da CLI do Azure.For installation instructions, see Install Azure CLI beta version.

Executar a CLI do AzureRun the Azure CLI

Agora, você pode executar a CLI do Azure com o comando az no Prompt de Comando do Windows ou no PowerShell.You can now run the Azure CLI with the az command from either Windows Command Prompt or PowerShell. O PowerShell oferece alguns recursos de conclusão de guia não disponíveis no prompt de comando do Windows.PowerShell offers some tab completion features not available from Windows Command Prompt. Para entrar, execute o comando az login.To sign in, run the az login command.

  1. Execute o comando login.Run the login command.

    az login
    

    Se a CLI puder abrir o navegador padrão, ela o fará e carregará uma página de entrada do Azure.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    Caso contrário, abra uma página de navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no terminal.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

    Se nenhum navegador da Web estiver disponível ou se não for possível abrir o navegador da Web, use o fluxo de código do dispositivo com az login --use-device-code.If no web browser is available or the web browser fails to open, use device code flow with az login --use-device-code.

  2. Entre com suas credenciais de conta no navegador.Sign in with your account credentials in the browser.

Para saber mais sobre os diferentes métodos de autenticação, confira Entrar com a CLI do Azure.To learn more about different authentication methods, see Sign in with Azure CLI.

Solução de problemasTroubleshooting

Veja alguns problemas comuns que ocorrem durante a instalação no Windows.Here are some common problems seen when installing on Windows. Se você tiver um problema não abordado aqui, arquive um problema no GitHub.If you experience a problem not covered here, file an issue on GitHub.

Conexão de blocos de proxyProxy blocks connection

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.If you can't download the MSI installer because your proxy is blocking the connection, make sure that you have your proxy properly configured. No Windows 10, essas configurações são gerenciadas no painel Settings > Network & Internet > Proxy.For Windows 10, these settings are managed in the Settings > Network & Internet > Proxy pane. 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.Contact your system administrator for the required settings, or for situations where your machine may be configuration-managed or require advanced setup.

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.These settings are also required to be able to access Azure services with the CLI, from both PowerShell or the Command Prompt. No PowerShell, faça isso com o seguinte comando:In PowerShell, you do this with the following command:

(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:In order to get the MSI, your proxy needs to allow HTTPS connections to the following addresses:

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

DesinstalarUninstall

Se você decidir desinstalar a CLI do Azure, lamentamos sua saída.If you decide to uninstall the Azure CLI, we're sorry to see you go. Antes de desinstalar, use o comando az feedback para nos informar sobre o que poderia ser melhorado ou corrigido.Before you uninstall, use the az feedback command to let us know what could be improved or fixed. Nosso objetivo é deixar a CLI do Azure livre de bugs e amigável ao usuário.Our goal is to make the Azure CLI bug-free and user-friendly. Se você encontrou um erro, agradeceríamos se registrasse um problema do GitHub.If you found a bug, we'd appreciate it if you file a GitHub issue.

Desinstale a CLI do Azure da lista de "Aplicativos e recursos" do Windows.You uninstall the Azure CLI from the Windows "Apps and Features" list. Para desinstalar:To uninstall:

PlataformaPlatform InstruçõesInstructions
Windows 10Windows 10 Iniciar > Configurações > AplicativosStart > Settings > Apps
Windows 8 e Windows 7Windows 8 and Windows 7 Iniciar > Painel de Controle > Programas > Desinstalar um programaStart > Control Panel > Programs > Uninstall a program

Uma vez nessa tela, digite CLI do Azure na barra de pesquisa do programa.Once on this screen type Azure CLI into the program search bar. O programa de desinstalação aparece como Microsoft CLI 2.0 para Azure.The program to uninstall is listed as Microsoft CLI 2.0 for Azure. Selecione este aplicativo e clique no botão Uninstall.Select this application, then click the Uninstall button.

Próximas etapasNext Steps

Agora que você instalou a CLI do Azure, faça um tour breve de seus recursos e comandos comuns.Now that you've installed the Azure CLI, take a short tour of its features and common commands.