Instalar o Azure PowerShellInstall Azure PowerShell

Este artigo explica como instalar os módulos do Azure PowerShell com o PowerShellGet.This article explains how to install the Azure PowerShell modules using PowerShellGet. Estas instruções funcionam nas plataformas Windows, macOS e Linux.These instructions work on Windows, macOS, and Linux platforms.

O Azure PowerShell também está disponível no Azure Cloud Shell e está agora pré-instalado nas imagens do Docker.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

RequisitosRequirements

Nota

A versão recomendada do PowerShell para utilização com o Azure PowerShell em todas as plataformas é o PowerShell 7.x e posteriores.PowerShell 7.x and later is the recommended version of PowerShell for use with Azure PowerShell on all platforms.

O Azure PowerShell funciona com o PowerShell 6.2.4 e posteriores em todas as plataformas.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. Também é suportado com o PowerShell 5.1 no Windows.It is also supported with PowerShell 5.1 on Windows. Instale a versão mais recente do PowerShell disponível para o seu sistema operativo.Install the latest version of PowerShell available for your operating system. O Azure PowerShell não tem requisitos adicionais quando é executado no PowerShell 6.2.4 e posteriores.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

Para consultar a sua versão do PowerShell, execute o comando:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Para utilizar o Azure PowerShell no PowerShell 5.1 no Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Atualize para o Windows PowerShell 5.1.Update to Windows PowerShell 5.1. Se utilizar o Windows 10, versão 1607 ou superior, já tem o PowerShell 5.1 instalado.If you're on Windows 10 version 1607 or higher, you already have PowerShell 5.1 installed.
  2. Instale o .NET Framework 4.7.2 ou posterior.Install .NET Framework 4.7.2 or later.
  3. Verifique se tem a versão mais recente do PowerShellGet.Make sure you have the latest version of PowerShellGet. Execute Install-Module -Name PowerShellGet -Force.Run Install-Module -Name PowerShellGet -Force.

Instalar o módulo do Azure PowerShellInstall the Azure PowerShell module

Aviso

Não suportamos os módulos do AzureRM e do Az instalados em simultâneo para o PowerShell 5.1 para Windows.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. Se precisar de manter o AzureRM disponível no sistema, instale o módulo do Az para o PowerShell 6.2.4 ou posterior.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

A utilização dos cmdlets do PowerShellGet é o método de instalação preferido.Using the PowerShellGet cmdlets is the preferred installation method. Instale o módulo do Az apenas no utilizador atual.Install the Az module for the current user only. Este é o âmbito de instalação recomendado.This is the recommended installation scope. Este método funciona da mesma forma nas plataformas Windows, macOS e Linux.This method works the same on Windows, macOS, and Linux platforms. Execute o seguinte comando a partir de uma sessão do PowerShell:Run the following command from a PowerShell session:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

Por predefinição, a galeria do PowerShell não está configurada como um repositório fidedigno para o PowerShellGet.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. Na primeira vez que utilizar o PSGallery verá a seguinte linha de comandos:The first time you use the PSGallery you see the following prompt:

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.Answer Yes or Yes to All to continue with the installation.

A instalação do módulo para todos os utilizadores num sistema requer privilégios elevados.Installing the module for all users on a system requires elevated privileges. Inicie a sessão do PowerShell com a opção Executar como administrador no Windows ou utilize o comando sudo no macOS ou Linux:Start the PowerShell session using Run as administrator in Windows or use the sudo command on macOS or Linux:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

O módulo do Az é um módulo de rollup para os cmdlets do Azure PowerShell.The Az module is a rollup module for the Azure PowerShell cmdlets. A instalação do mesmo transfere todos os módulos do Az do PowerShell em disponibilidade geral e disponibiliza os respetivos cmdlets para utilização.Installing it downloads all of the generally available Az PowerShell modules, and makes their cmdlets available for use.

Instalar offlineInstall offline

Em alguns ambientes, não é possível ligar à Galeria do PowerShell.In some environments, it's not possible to connect to the PowerShell Gallery. Nessas situações, ainda pode instalar offline através de um destes métodos:In those situations, you can still install offline using one of these methods:

  • Transfira os módulos para outra localização na sua rede e utilize-os como uma origem de instalação.Download the modules to another location in your network and use that as an installation source. Este método permite-lhe colocar em cache os módulos do PowerShell num único servidor ou que seja implementada a partilha de ficheiros através do PowerShellGet para quaisquer sistemas desligados.This method allows you to cache PowerShell modules on a single server or file share to be deployed with PowerShellGet to any disconnected systems. Saiba como configurar um repositório local e instalar em sistemas desligados com a opção Trabalhar com repositórios do PowerShellGet locais.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • Transferira o MSI do Azure PowerShell para um computador ligado a uma rede e, em seguida, copie o instalador para os sistemas sem o acesso à Galeria do PowerShell.Download the Azure PowerShell MSI to a machine connected to the network, and then copy the installer to systems without access to PowerShell Gallery. Tenha em mente que o instalador MSI funciona apenas para o PowerShell 5.1 no Windows.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Guarde o módulo com Guardar-Módulo numa partilha de ficheiros ou guarde noutra fonte e faça a cópia manualmente para outros computadores:Save the module with Save-Module to a file share, or save it to another source and manually copy it to other machines:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Resolução de problemasTroubleshooting

Seguem-se alguns problemas comuns vistos durante a instalação do módulo do Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Se detetar um problema não mencionado neste artigo, registe um problema no GitHub.If you experience a problem not listed here, file an issue on GitHub.

O proxy bloqueia a ligaçãoProxy blocks connection

Se ocorrerem erros de Install-Module que indiquem que a Galeria do PowerShell não está acessível, pode estar atrás de um proxy.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Diferentes sistemas operativos e ambientes de rede têm requisitos diferentes para configurar um proxy ao nível do sistema.Different operating systems and network environment have different requirements for configuring a system-wide proxy. Contacte o administrador de sistema para obter as suas definições de proxy e saber como configurá-las para o seu ambiente.Contact your system administrator for your proxy settings and how to configure them for your environment.

O PowerShell não pode ser configurado para utilizar este proxy automaticamente.PowerShell itself may not be configured to use this proxy automatically. Com o PowerShell 5.1 e posterior, pode configurar a sessão do PowerShell para utilizar um proxy com o seguinte comando:With PowerShell 5.1 and later, configure the PowerShell session to use a proxy using the following commands:

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Se as credenciais do seu sistema operativo estiverem configuradas corretamente, esta configuração encaminha os pedidos do PowerShell através do proxy.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. Para manter esta definição entre sessões, adicione os comandos ao seu perfil do PowerShell.To have this setting persist between sessions, add the commands to your PowerShell profile.

Para instalar o pacote, o proxy tem de permitir ligações HTTPS no seguinte endereço:To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

Iniciar sessãoSign in

Para começar a trabalhar com o Azure PowerShell, inicie sessão com as suas credenciais do Azure.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Nota

Se tiver desativado o carregamento automático do módulo, importe o módulo manualmente com Import-Module -Name Az.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. Devido à forma como o módulo está estruturado, esta operação pode demorar alguns segundos.Because of the way the module is structured, this can take a few seconds.

Irá precisar de repetir estes passos para cada nova sessão do PowerShell iniciada.You'll need to repeat these steps for every new PowerShell session you start. Para saber como manter o início de sessão do Azure entre sessões do PowerShell, veja Manter as credenciais do utilizador entre sessões do PowerShell.To learn how to persist your Azure sign in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Atualizar o módulo do Azure PowerShellUpdate the Azure PowerShell module

Para atualizar qualquer módulo do PowerShell, deve utilizar o mesmo método utilizado para instalar o módulo.To update any PowerShell module, you should use the same method used to install the module. Por exemplo, se utilizou originalmente Install-Module, deve utilizar Update-Module para obter a versão mais recente.For example, if you originally used Install-Module, then you should use Update-Module to get the latest version. Se utilizou originalmente o pacote MSI, deve transferir e instalar o novo pacote MSI.If you originally used the MSI package then you should download and install the new MSI package.

Os cmdlets do PowerShellGet não conseguem atualizar os módulos instalados a partir de um pacote MSI.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. Os pacotes MSI não atualizam os módulos instalados com o PowerShellGet.MSI packages do not update modules that were installed using PowerShellGet. Se tiver problemas ao utilizar o PowershellGet, deve reinstalá-lo, em vez de o atualizar.If you have any issues updating using PowershellGet, then you should reinstall, rather than update. A reinstalação é feita como a instalação, mas terá ter de adicionar o parâmetro -Force:Reinstalling is done the same way as installing, but you need to add the -Force parameter:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

Ao contrário das instalações baseadas em MSI, instalar ou atualizar com o PowerShellGet não remove as versões mais antigas que possam existir no seu sistema.Unlike MSI-based installations, installing or updating using PowerShellGet does not remove older versions that may exist on your system. Para remover as versões antigas do Azure PowerShell do seu sistema, veja Desinstalar o módulo do Azure PowerShell.To remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module. Para obter mais informações sobre instalações baseadas em MSI, veja Instalar o Azure PowerShell com um MSI.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

Utilizar várias versões do Azure PowerShellUse multiple versions of Azure PowerShell

Pode instalar mais de uma versão do Azure PowerShell.It's possible to install more than one version of Azure PowerShell. Para verificar se tem várias versões do Azure PowerShell instaladas, utilize o seguinte comando:To check if you have multiple versions of Azure PowerShell installed, use the following command:

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

Para remover uma versão do Azure PowerShell, veja Desinstalar o módulo do Azure PowerShell.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Se tiver mais do que uma versão do módulo instalada, faça o carregamento automático do módulo e carregue a versão mais recente com Import-Module por predefinição.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

Pode instalar ou carregar uma versão específica do módulo Az com o parâmetro -RequiredVersion:You can install or load a specific version of the Az module using the -RequiredVersion parameter:

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

Utilizar vários repositórios no PowerShellGetUse multiple repositories with PowerShellGet

O parâmetro Repository é necessário se tiver repositórios adicionais ao PowerShellGet no seu sistema e o módulo do Az se encontrar em mais de um desses repositórios.The Repository parameter is required if you have added additional repositories to PowerShellGet on your system and the Az module can be found in more than one of them.

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message 'Az module not installed. Having both the AzureRM and Az modules installed at the same time is not supported.'
} else {
    Install-Module -Name Az -Repository PSGallery -AllowClobber -Force
}

Enviar comentáriosProvide feedback

Se encontrar um erro no Azure PowerShell, registe um problema no GitHub.If you find a bug in Azure PowerShell, file an issue on GitHub. Para enviar comentários a partir da linha de comandos, experimente o cmdlet Send-Feedback.To provide feedback from the command line, use the Send-Feedback cmdlet.

Passos SeguintesNext Steps

Para saber mais sobre os módulos do Azure PowerShell e as respetivas funcionalidades, veja Introdução ao Azure PowerShell.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Se estiver familiarizado com o Azure PowerShell e precisar de migrar do AzureRM, veja Migrar do AzureRM para o Az.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.