Compartilhar via


Instalar o Azure PowerShell no Windows

O módulo Az do PowerShell é cumulativo. A instalação do módulo Az do PowerShell baixa os módulos com disponibilidade geral e disponibiliza os cmdlets associados para uso.

O método de instalação e a versão do PowerShell recomendados para o módulo Az do PowerShell:

  • Instalação por meio da Galeria do PowerShell
  • Usar com o PowerShell 7 ou superior

Este artigo explica como instalar o módulo Az do PowerShell no Windows por meio da Galeria do PowerShell.

Pré-requisitos

  • Execute o seguinte comando no PowerShell para determinar a versão do PowerShell:

    $PSVersionTable.PSVersion
    
  • Determine se você tem o módulo AzureRM PowerShell instalado:

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

    Se você tiver o módulo AzureRM PowerShell instalado, confira Coexistência do Az e do AzureRM antes de prosseguir.

  • Definir a política de execução do PowerShell como assinada remotamente ou menos restritiva

    • Veja a política de execução do PowerShell:

      Get-ExecutionPolicy -List
      
    • Defina a política de execução do PowerShell como assinada remotamente:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Para saber mais sobre as políticas de execução, confira about_Execution_Policies.

Instalação

Use o cmdlet Install-Module para instalar o módulo Az do PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Atualizar o módulo Az do PowerShell

Use Update-Module a fim de realizar a atualização para a versão mais recente do módulo Az do PowerShell:

Update-Module -Name Az -Force

Ao atualizar o módulo Az do PowerShell por meio de Update-Module, as versões antigas desse módulo não são removidas do sistema.

Desinstalação

Para remover o módulo Az do PowerShell, confira Desinstalar o módulo do Azure PowerShell.

Este artigo explica como instalar o módulo Az do PowerShell no Windows por meio de um instalador de MSI. O instalador do MSI (Microsoft Windows Installer) é fornecido para ambientes em que a Galeria do PowerShell pode ser bloqueada por um firewall ou em que um instalador offline é necessário.

Importante

A opção de instalação de MSI só pode ser usada ao instalar o módulo Az do PowerShell para uso com o Windows PowerShell 5.1.

Pré-requisitos

  • Execute o seguinte comando no PowerShell para determinar a versão do PowerShell:

    $PSVersionTable.PSVersion
    
  • Determinar se você tem o módulo AzureRM PowerShell instalado

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

    Se você tiver o módulo AzureRM PowerShell instalado, confira Coexistência do Az e do AzureRM antes de prosseguir.

  • Atualizar para o Windows PowerShell 5.1

  • Instalar o .NET Framework 4.7.2 ou superior

  • Defina a execução de script do PowerShell como assinada remotamente ou menos restritiva

    • Veja a política de execução do PowerShell:

      Get-ExecutionPolicy -List
      
    • Defina a política de execução do PowerShell como assinada remotamente:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Para saber mais sobre as políticas de execução, confira about_Execution_Policies.

Instalação e atualização

O pacote MSI para o Azure PowerShell está disponível no GitHub:

  1. Visite github.com/Azure/azure-powershell/releases
  2. Localize o módulo Az do PowerShell mais recente. Eles são listados cronologicamente sem nome. Por exemplo, 9.5.0
  3. Role para baixo até o final das notas de patch e clique na seta ao lado de "Ativos" para revelar as opções de MSI.
  4. Clique no MSI Az-Cmdlets desejado para iniciar o download.

O instalador remove automaticamente as versões mais antigas do módulo Az do PowerShell que foram instaladas usando um MSI. O pacote MSI instala os módulos em "${env:ProgramFiles}\WindowsPowerShell\Modules"

Entrar

Para começar a gerenciar os recursos do Azure com o módulo Az do PowerShell, inicie uma sessão do PowerShell e execute Connect-AzAccount para entrar no Azure:

Connect-AzAccount

Use as credenciais de logon da conta do Azure para o logon na janela do navegador que é aberta.

Será necessário repetir essa etapa para cada sessão nova do PowerShell que você iniciar. Para saber como persistir a entrada no Azure nas sessões do PowerShell, confira Objetos de contexto do Azure PowerShell.

Solução de problemas

Para obter soluções para problemas comuns de instalação do módulo Az do PowerShell, confira Solucionar problemas de instalação do módulo Az do PowerShell.

Fornecer comentários

Para registrar um problema sobre o módulo Az do PowerShell, confira Registrar um problema no GitHub

Para fornecer comentários de dentro de uma sessão do PowerShell, use o cmdlet Send-Feedback.

Próximas etapas

Para saber como gerenciar os recursos do Azure com o módulo Az do PowerShell, confira Introdução ao Azure PowerShell.