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 recomendado e a versão do PowerShell para o módulo do Az PowerShell:

  • Instalar por meio da Galeria do PowerShell
  • Usar com o PowerShell versão 7 ou superior

Este artigo explica como instalar o módulo do Az PowerShell no Windows por meio 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 do PowerShell do AzureRM instalado:

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

    Se você tiver o módulo do PowerShell do AzureRM instalado, consulte a coexistência do AzureRM e do AzureRM antes de continuar.

  • Definir a política de execução do PowerShell como remota assinada 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 saber mais sobre as políticas de execução, confira about_Execution_Policies.

Installation

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

Install-Module -Name Az -Repository PSGallery -Force

Atualizar o módulo do Az PowerShell

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

Update-Module -Name Az -Force

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

Desinstalação

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

Este artigo explica como instalar o módulo do Az PowerShell no Windows usando um instalador MSI. O instalador msi é fornecido para ambientes em que 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 do 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
    
  • Determinar se você tem o módulo do PowerShell do AzureRM instalado

    Get-Module -Name AzureRM -ListAvailable
    

    Importante

    Se você tiver o módulo do PowerShell do AzureRM instalado, consulte a coexistência do AzureRM e do AzureRM antes de continuar.

  • Atualizar para o Windows PowerShell 5.1

  • Instalar o .NET Framework 4.7.2 ou posterior

  • Definir a execução de script do PowerShell como remota assinada 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 do Azure PowerShell está disponível no [GitHub][azps-github]:

  1. Visite github.com/Azure/azure-powershell/releases
  2. Localize o módulo mais recente do Az PowerShell. Eles estão listados cronologicamente sem nome. Por exemplo, 13.3.0
  3. Role para baixo até o final das anotações de patch e selecione a seta ao lado de "Ativos" para revelar as opções de 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 do Az PowerShell que foram instaladas usando uma 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 do Az 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.

Você precisa repetir esta etapa para cada nova sessão do PowerShell iniciada. Para saber como manter sua entrada no 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 do Az PowerShell, consulte Solucionar problemas de instalação com o módulo do Az PowerShell.

Fornecer comentários

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

Para fornecer comentários de dentro de uma sessão do PowerShell, use o cmdlet Enviar Comentários .

Próximas etapas

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