Compartilhar via


Instalar 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 PowerShell Gallery
  • Usar com o PowerShell versão 7 ou superior

Este artigo explica como instalar o módulo Az PowerShell em Windows a partir do PowerShell Gallery.

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 tiver o módulo AzureRM PowerShell instalado, consulte a coexistência entre Az e AzureRM antes de continuar.

  • Instalar uma versão suportada do PowerShell versão 7 ou superior
  • 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 [método/especificação] não remove versões antigas do módulo Az PowerShell do seu sistema.

Desinstalação

Para remover o módulo Az PowerShell, veja 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 PowerShell Gallery pode estar bloqueada por um firewall, ou onde é necessário um instalador offline.

Importante

A opção de instalação do 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 tiver o módulo AzureRM PowerShell instalado, consulte a coexistência Az e AzureRM antes de continuar.

  • Atualização para Windows PowerShell 5.1

  • Instala 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,
  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

Entrar

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

Connect-AzAccount

Use as credenciais de login da sua conta Azure para iniciar sessão na janela do navegador que abre.

Você precisa repetir esta etapa para cada nova sessão do PowerShell iniciada. Para aprender a persistir o seu início de sessão no Azure em sessões do PowerShell, veja objetos de contexto do Azure PowerShell.

Troubleshooting

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 apresentar uma questão sobre o módulo Az PowerShell, veja: Apresentar uma issue em 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 a gestão dos seus recursos de Azure com o módulo Az PowerShell, consulte Comece com Azure PowerShell.