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 disponíveis ao público e disponibiliza os 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.

Installation

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 um firewall ou um instalador offline é necessário.

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][execution-poliicies].

Instalação e atualização

O pacote MSI para Azure PowerShell está disponível em [GitHub][azps-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, 13.3.0
  3. Role para baixo até o final das notas do patch e selecione a seta ao lado de "Ativos" para revelar as opções MSI.
  4. Selecione o 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"

Entrar

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.

Você precisa repetir esta etapa para cada nova sessão do PowerShell iniciada. Para saber como manter sua entrada do Azure em sessões do PowerShell, consulte Objetos de contexto do Azure PowerShell.

Soluçã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.

Fornecer 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 .

Próximas Etapas

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