Partilhar via


Instalar o Azure PowerShell no Windows

O módulo Az PowerShell é um módulo cumulativo. A instalação do módulo Az PowerShell baixa os módulos geralmente disponíveis e disponibiliza seus cmdlets para uso.

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

  • Instalar a partir da Galeria do PowerShell
  • Usar com o PowerShell versão 7 ou superior

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

Pré-requisitos

  • Execute o seguinte comando do PowerShell para determinar sua 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, consulte Az e AzureRM coexistência antes de continuar.

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

    • Verifique 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 obter mais informações sobre políticas de execução, consulte about_Execution_Policies.

Instalação

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

Install-Module -Name Az -Repository PSGallery -Force

Atualizar o módulo Az PowerShell

Use Update-Module para atualizar para a versão mais recente do módulo Az PowerShell:

Update-Module -Name Az -Force

Atualizar o módulo Az PowerShell usando Update-Module não remove versões antigas do módulo Az PowerShell do seu sistema.

Desinstalação

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

Este artigo explica como instalar o módulo Az PowerShell no Windows usando um instalador MSI. O instalador MSI é fornecido para ambientes onde a Galeria do PowerShell pode ser bloqueada por uma firewall ou onde for necessário um instalador offline.

Importante

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

Pré-requisitos

  • Execute o seguinte comando do PowerShell para determinar sua 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, consulte Az e AzureRM coexistência antes de continuar.

  • Atualização para o Windows PowerShell 5.1

  • Instalar o .NET Framework 4.7.2 ou posterior

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

    • Verifique 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 obter mais informações sobre políticas de execução, consulte about_Execution_Policies.

Instalação e atualização

O pacote MSI para o Azure PowerShell está disponível a partir do GitHub:

  1. Visite github.com/Azure/azure-powershell/releases
  2. Localize o módulo Az 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 MSI.
  4. Clique no Az-Cmdlets MSI de sua escolha para iniciar o download

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

Iniciar sessão

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

Connect-AzAccount

Utilize as credenciais de início de sessão da sua conta do Azure para iniciar sessão na janela do browser que se abre.

Terá de repetir este passo para cada nova sessão do PowerShell que iniciar. Para saber como manter sua entrada do Azure em sessões do PowerShell, consulte Objetos de contexto do Azure PowerShell.

Resolução de Problemas

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

Enviar comentários

Para registrar um problema sobre o módulo Az PowerShell, consulte: arquivar um problema no GitHub

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

Passos Seguintes

Para saber mais sobre como gerenciar seus recursos do Azure com o módulo Az PowerShell, consulte Introdução ao Azure PowerShell.