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 AzureRM PowerShell instalado, consulte a coexistência de Az e AzureRM 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 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 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.

  • Last updated on