Compartilhar via


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

Este artigo explica como instalar o módulo do Az PowerShell em Windows do 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 AzureRM PowerShell instalado, consulte a coexistência de Az e 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

Utilize Update-Module para atualizar para a versão mais recente do módulo 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 Azure PowerShell.

Este artigo explica como instalar o módulo do Az PowerShell em Windows usando um instalador MSI. O instalador msi é fornecido para ambientes em que o Galeria do PowerShell pode ser bloqueado 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 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 Az antes de continuar.

  • Atualizar para Windows PowerShell 5.1

  • Instale .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 para Azure PowerShell está disponível em [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 de 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 suas credenciais de logon da conta 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 sua entrada Azure em sessões do PowerShell, consulte Azure PowerShell objetos de contexto.

Soluçã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 apresentar um problema sobre o módulo do Az PowerShell, consulte: File 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 de Azure com o módulo do Az PowerShell, consulte Get Iniciado com Azure PowerShell.