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.