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

Instalação

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

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 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 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 fazer logon na janela do navegador que é aberta.

Você precisa repetir esta etapa para cada nova sessão do PowerShell iniciada. Para saber como persistir a entrada no Azure nas sessões do PowerShell, confira 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 Send-Feedback.

Próximas etapas

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