Instalar o Azure PowerShell no Windows com o PowerShellGet

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Esse artigo explica as etapas para instalar os módulos do Azure PowerShell para o PowerShell 5.x do Windows usando o PowerShellGet. O PowerShellGet e o gerenciamento de módulos são os modos preferidos de instalação do Azure PowerShell, mas se você quiser instalar com o Web Platform Installer ou o pacote do MSI, consulte Outros métodos de instalação.

Não há suporte para o modelo de implantação clássico do Azure desta versão do Azure PowerShell. Para obter suporte com as implantações clássicas, siga as instruções em Instalar o módulo de Gerenciamento de Serviços do Azure PowerShell.

Importante

Não há suporte para o módulo do AzureRM para macOS ou Linux. Para usar os cmdlets do Azure PowerShell nessas plataformas, Instalar o módulo Az.

Requisitos

Começando com o Azure PowerShell versão 6.0, o Azure PowerShell requer o PowerShell versão 5.0. Para verificar a versão do PowerShell em execução no computador, execute o seguinte comando:

$PSVersionTable.PSVersion

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

Importante

O módulo descrito neste documento, AzureRM, usa o .NET Framework. Isso o torna incompatível com o PowerShell 6.0, que usa o .NET Core. Se você estiver usando o PowerShell 6.0, siga as instruções de instalação para o macOS e o Linux.

Instalar módulo do Azure PowerShell

Você precisa de privilégios elevados para instalar os módulos da Galeria do PowerShell. Para instalar o Azure PowerShell, execute o comando a seguir em uma sessão elevada:

Install-Module -Name AzureRM -AllowClobber

Observação

Caso sua versão seja mais antiga que a 2.8.5.201 do NuGet, será necessário baixar e instalar a versão mais recente do NuGet.

Por padrão, a galeria do PowerShell não está configurada como um repositório confiável para o PowerShellGet. Na primeira vez em que a PSGallery for utilizada, o prompt a seguir será exibido:

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 a instalação.

O módulo AzureRM é um módulo de rollup para os cmdlets do Azure PowerShell. A instalação dele baixa todos os módulos disponíveis do Azure Resource Manager e possibilita usar seus cmdlets.

Entrar

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

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

Observação

Se você desabilitou o carregamento automático do módulo, precisará importar manualmente o módulo com Import-Module AzureRM. Por causa da maneira como o módulo está estruturado, isso pode levar alguns segundos.

Será necessário repetir essas etapas para cada sessão nova do PowerShell que você iniciar. Para aprender a manter a entrada no Azure entre as sessões do PowerShell, confira Manter credenciais do usuário entre as sessões do PowerShell.

Atualizar o módulo do Azure PowerShell

Você pode atualizar sua instalação do Azure PowerShell executando Update-Module. Esse comando não desinstala as versões anteriores.

Update-Module -Name AzureRM

Se quiser remover as versões mais antigas do Azure PowerShell do sistema, consulte Desinstalar o módulo do Azure PowerShell.

Usar várias versões do Azure PowerShell

É possível instalar mais de uma versão do Azure PowerShell. Para verificar se você tem diversas versões do Azure PowerShell instaladas, use o seguinte comando:

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

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

Talvez seja necessário mais de uma versão se você trabalhar com recursos locais do Azure Stack, executar uma versão anterior do Windows ou usar o modelo de implantação clássico do Azure. Para instalar uma versão mais antiga, forneça o argumento -RequiredVersion na instalação.

# 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 padrão. Para carregar uma versão diferente, especifique o parâmetro RequiredVersion.

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

Fornecer comentários

Se você encontrar um bug ao usar o Azure Powershell, registre o problema no GitHub. Para fazer comentários na linha de comando, use o cmdlet Send-Feedback.

Próximas Etapas 

Para começar a usar o Azure PowerShell, consulte Introdução ao Azure PowerShell para saber mais sobre o módulo e seus recursos.