Instalar o módulo Az PowerShell do Azure

Este artigo explica como instalar o módulo Az PowerShell do Azure usando A Galeria do PowerShell. Essas instruções funcionam nas plataformas Windows, Linux e macOS.

O módulo Az PowerShell do Azure é pré-instalado no Azure Cloud Shell e nas imagens do Docker.

O módulo Az PowerShell do Azure é um módulo de rollup. A instalação dele baixa todos os módulos do Az PowerShell em disponibilidade geral e possibilita o uso dos respectivos cmdlets.

Requisitos

Observação

Recomenda-se o PowerShell 7.0.6 LTS, o PowerShell 7.1.3 ou versão posterior para uso com o módulo Az PowerShell do Azure em todas as plataformas.

O Azure PowerShell não tem requisitos adicionais quando executado no PowerShell 7.0.6 LTS, no PowerShell 7.1.3 ou em versão posterior.

Para verificar sua versão do PowerShell, execute o seguinte comando de dentro de uma sessão do PowerShell:

$PSVersionTable.PSVersion

A política de execução de script do PowerShell deve ser definida como assinada remotamente ou menos restritiva. É possível usar Get-ExecutionPolicy -List para determinar a política de execução atual. Para obter mais informações, consulte about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalação

O uso do cmdlet Install-Module é o método de instalação preferencial do módulo Az PowerShell. Instale o módulo Az somente para o usuário atual. Este é o escopo de instalação recomendado. Esse método funciona da mesma forma nas plataformas Windows, Linux e macOS. Execute o seguinte comando em uma sessão do PowerShell:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Outras opções de instalação

Embora o PowerShell 7.0.6 LTS, o PowerShell 7.1.3 ou versão posterior seja recomendada e Install-Module seja a opção de instalação recomendada, há outras opções de instalação, se necessário.

Instalação no Windows PowerShell

Importante

Se você tiver o módulo AzureRM PowerShell instalado, confira Coexistência do Az e do AzureRM antes de prosseguir.

O módulo Az PowerShell do Azure também é compatível com o PowerShell 5.1 no Windows. Para usar o módulo Az PowerShell do Azure no PowerShell 5.1 no Windows:

  1. Atualize para o Windows PowerShell 5.1. Se você está usando o Windows 10 versão 1607 ou superior, você já tem o PowerShell 5.1 instalado.
  2. Instale o .NET Framework 4.7.2 ou posterior.
  3. Verifique se tem a versão mais recente do PowerShellGet. Execute Install-Module -Name PowerShellGet -Force.

Instalação offline

Em alguns ambientes, não é possível se conectar à Galeria do PowerShell. Nessas situações, você ainda pode instalar o módulo Az PowerShell offline usando um desses métodos:

  • Baixar o MSI do Azure PowerShell. Tenha em mente que o instalador do MSI só funciona para PowerShell 5.1 no Windows.
  • Baixe os módulos em outro local da sua rede e use-os como uma origem de instalação. Esse método permite que você armazene módulos do PowerShell em cache em um único servidor ou compartilhamento de arquivo para serem implantados com o PowerShellGet em sistemas desconectados. Saiba como configurar um repositório local e instalar em sistemas desconectados com Trabalhar com repositórios PowerShellGet locais.
  • Salve o módulo com Save-Module em um compartilhamento de arquivo em outra fonte e copie-o manualmente para outros computadores.

Entrar

Para começar a trabalhar com o Azure PowerShell, entre com suas credenciais do Azure.

Connect-AzAccount

Depois da execução desse comando, uma nova janela do navegador é aberta, e você pode entrar na sua conta do Azure.

Atualizar o módulo do Azure PowerShell

Para atualizar qualquer módulo do PowerShell, você deve usar o mesmo método usado para instalar o módulo. Por exemplo, caso tenha usado Install-Module originalmente, você deverá usar Update-Module para obter a versão mais recente. Caso tivesse usado originalmente o pacote MSI, você deveria baixar e instalar o novo pacote MSI.

Os cmdlets do PowerShellGet não podem atualizar os módulos que foram instalados por meio de um pacote MSI. Os pacotes MSI não atualizam módulos que foram instalados usando o PowerShellGet. Se você tiver problemas ao atualizar usando o PowerShellGet, deverá reinstalar em vez de atualizar. A reinstalação é feita da mesma forma que a instalação. Não se esqueça de usar o parâmetro Force com Install-Module na reinstalação.

Diferentemente das instalações baseadas em MSI, instalar ou atualizar usando o PowerShellGet não remove as versões mais antigas que possam existir em seu sistema.

Observação

Pode ser complicado fazer a desinstalação se você tem mais de uma versão do módulo Az PowerShell instalada. Por causa dessa complexidade, só permitimos a desinstalação de todas as versões do módulo Az PowerShell que estão instaladas no momento.

Para remover todas as versões do módulo Az PowerShell do sistema, confira Desinstalar o módulo do Azure PowerShell. Para obter mais informações sobre instalações baseadas em MSI, consulte Instalar o Azure PowerShell com um MSI.

Solução de problemas

Solucione problemas de instalação com o módulo Az PowerShell do Azure.

Fornecer comentários

Se você encontrar um bug no módulo Az PowerShell do Azure, registre o 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 os módulos Az PowerShell do Azure e os recursos deles, confira Introdução ao Azure PowerShell. Se você estiver familiarizado com o Azure PowerShell e precisar migrar do AzureRM, confira Migrar do AzureRM para Az.