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.