Instalar o Azure PowerShell no Windows com o PowerShellGet

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Este artigo explica os passos para instalar os módulos do Azure PowerShell para o PowerShell 5.x para Windows com o PowerShellGet. O PowerShellGet e a gestão do módulo constituem a forma preferencial de instalar o Azure PowerShell, mas se preferir instalar com o Instalador de Plataforma Web ou o pacote MSI, veja Outros métodos de instalação.

O modelo de implementação clássica do Azure não é suportado por esta versão do Azure PowerShell. Para suportar implementações clássicas, siga as instruções em Instalar o módulo de Gestão de Serviço do Azure PowerShell.

Importante

O módulo AzureRM não é suportado para macOS ou Linux. Para utilizar cmdlets do Azure PowerShell nestas plataformas, Instale o módulo Az.

Requisitos

A partir do Azure PowerShell versão 6.0, o Azure PowerShell requer a versão 5.0 do PowerShell. Para verificar a versão do PowerShell em execução na sua máquina, executa o seguinte comando:

$PSVersionTable.PSVersion

Se tiver uma versão desatualizada, consulte Atualizar o Windows PowerShell existente.

Importante

O módulo descrito neste documento, o AzureRM, utiliza o .NET Framework. Isto torna-o incompatível com o PowerShell 6.0, que utiliza o .NET Core. Se estiver a utilizar o PowerShell 6.0, siga as instruções de instalação para macOS e Linux.

Instalar o módulo do Azure PowerShell

Precisa de privilégios elevados para instalar módulos da Galeria do PowerShell. Para instalar o Azure PowerShell, execute o seguinte comando numa sessão elevada:

Install-Module -Name AzureRM -AllowClobber

Nota

Se tiver uma versão mais antiga do que a 2.8.5.201 do NuGet, será pedido que transfira e instale a versão mais recente do NuGet.

Por predefinição, a galeria do PowerShell não está configurada como um repositório fidedigno para o PowerShellGet. Na primeira vez que utilizar o PSGallery, verá a seguinte linha de comandos:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Responda Yes ou Yes to All para continuar com a instalação.

O módulo AzureRM é um módulo de rollup para os cmdlets do Azure PowerShell. A instalação do mesmo transfere todos os módulos disponíveis do Azure Resource Manager e disponibiliza os respetivos cmdlets para utilização.

Iniciar sessão

Para começar a trabalhar com o Azure PowerShell, inicie sessão com as suas credenciais do Azure.

# Connect to Azure with an interactive dialog for sign-in
Connect-AzureRmAccount

Nota

Se tiver desativado o carregamento automático do módulo, tem de importar o módulo manualmente com Import-Module AzureRM. Devido à forma como o módulo está estruturado, esta operação pode demorar alguns segundos.

Irá precisar de repetir estes passos para cada nova sessão do PowerShell iniciada. Para saber como manter o início de sessão do Azure nas sessões do PowerShell, veja Manter as credenciais do utilizador nas sessões do PowerShell.

Atualizar o módulo do Azure PowerShell

Pode atualizar a sua instalação do Azure PowerShell ao executar Update-Module. Este comando não desinstala as versões anteriores.

Update-Module -Name AzureRM

Se pretende remover as versões anteriores do Azure PowerShell do seu sistema, veja Desinstalar o módulo do Azure PowerShell.

Utilizar várias versões do Azure PowerShell

Pode instalar mais de uma versão do Azure PowerShell. Para verificar se tem várias versões do Azure PowerShell instaladas, utilize o seguinte comando:

Get-InstalledModule -Name AzureRM -AllVersions |
  Select-Object -Property Name, Version

Para remover uma versão do Azure PowerShell, veja Desinstalar o módulo do Azure PowerShell.

Poderá precisar de mais de uma versão se trabalhar com recursos do Azure Stack no local, executar uma versão mais antiga do Windows ou utilizar o modelo de implementação clássica do Azure. Para instalar uma versão anterior, apresente o argumento -RequiredVersion ao instalar.

# Install version 2.3.0 of Azure PowerShell
Install-Module -Name AzureRM -RequiredVersion 2.3.0

Ao carregar o módulo do Azure PowerShell, a versão mais recente é carregada por predefinição. Para carregar uma versão diferente, especifique o RequiredVersion parâmetro.

# Load version 2.3.0 of Azure PowerShell
Import-Module -Name AzureRM -RequiredVersion 2.3.0

Enviar comentários

Se encontrar um erro ao utilizar o Azure Powershell, registe um erro no GitHub. Para enviar comentários a partir da linha de comandos, experimente o cmdlet Send-Feedback.

Passos Seguintes

Para começar a utilizar o Azure PowerShell, veja Introdução ao Azure PowerShell para saber mais sobre o módulo e os respetivos recursos.