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

Este artigo mostra-lhe como instalar os módulos do Azure PowerShell com o PowerShellGet.This article tells you 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. Não existem outros métodos de instalação suportados atualmente para o módulo do Az.For the Az module, currently no other installation methods are supported.

RequisitosRequirements

O Azure PowerShell funciona com o PowerShell 5.1 ou superior no Windows, ou com o PowerShell Core 6.x e posterior em todas as plataformas.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Se não tiver a certeza se tem o PowerShell, ou está no macOS ou Linux, instale a versão mais recente do PowerShell Core.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of PowerShell Core.

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

$PSVersionTable.PSVersion

Para executar o Azure PowerShell no PowerShell 5.1 no Windows:To run Azure PowerShell in PowerShell 5.1 on Windows:

  1. Atualize para o Windows PowerShell 5.1 se for necessário.Update to Windows PowerShell 5.1 if needed. Se estiver no Windows 10, já tem o PowerShell 5.1 instalado.If you're on Windows 10, 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.

Não existem requisitos adicionais para o Azure PowerShell quando utilizar o PowerShell Core.There are no additional requirements for Azure PowerShell when using PowerShell Core.

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

Aviso

Não pode ter os módulos AzureRM e Az instalados em simultâneo para o PowerShell 5.1 para Windows.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Se precisar de manter o AzureRM disponível no sistema, instale o módulo do Az para o PowerShell Core 6.x ou posterior.If you need to keep AzureRM available on your system, install the Az module for PowerShell Core 6.x or later. Para tal, instale o PowerShell Core 6.x ou posterior e, em seguida, siga estas instruções num terminal do PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

Para instalar módulo num âmbito global, precisa de privilégios elevados para instalar módulos da Galeria do PowerShell.To install modules at a global scope, you need elevated privileges to install modules from the PowerShell Gallery. Para instalar o Azure PowerShell, execute o seguinte comando numa sessão elevada ("Executar como Administrador" no Windows, ou com privilégios de superutilizador no macOS ou Linux):To install Azure PowerShell, run the following command in an elevated session ("Run as Administrator" on Windows, or with superuser privileges on macOS or Linux):

Install-Module -Name Az -AllowClobber

Se não tiver acesso a privilégios de administrador, pode instalar para o utilizador atual, ao adicionar o argumento -Scope.If you don't have access to administrator privileges, you can install for the current user by adding the -Scope argument.

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.

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 disponíveis do Azure Resource Manager e disponibiliza os respetivos cmdlets para utilização.Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

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, please 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 têm requisitos diferentes para configurar um proxy ao nível do sistema, não abordados detalhadamente aqui.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Contacte o administrador de sistema para obter as suas definições de proxy e saber como configurá-las para o seu SO.Contact your system administrator for your proxy settings and how to configure them for your OS.

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 o proxy a utilizar numa sessão do PowerShell com o seguinte comando:With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Se as credenciais do seu sistema operativo estiverem configuradas corretamente, os pedidos do PowerShell serão encaminhados através do proxy.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Para manter esta definição entre sessões, adicione o comando a um perfil do PowerShell.In order to have this setting persist between sessions, add the command to a PowerShell profile.

Para instalar o pacote, o proxy tem de permitir ligações HTTPS no seguinte endereço:In order 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, tem de importar o módulo manualmente com Import-Module Az.If you've disabled module autoloading, you need to manually import the module with Import-Module 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 nas sessões do PowerShell, veja Manter as credenciais do utilizador nas 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

Devido à forma como o módulo do Az é empacotado, o comando Update-Module não atualizará a sua instalação corretamente.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. O AZ é tecnicamente um meta-módulo que abrange todos os submódulos que contêm cmdlets para interagir com os serviços do Azure.Az is technically a meta-module, encompassing all of the submodules that contain cmdlets to interact with Azure services. Isso significa que para atualizar o módulo do Azure PowerShell, terá de o reinstalar, em vez de apenas o atualizar.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Isto é feito como a instalação, mas poderá ter de adicionar o argumento -Force:This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Embora os módulos instalados possam ser substituídos, poderá ainda ter versões antigas no seu sistema.Although this can overwrite installed modules, you may still have older versions left on your system. Para obter mais informações sobre como remover as versões antigas do Azure PowerShell do seu sistema, veja Desinstalar o módulo do Azure PowerShell.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

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 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.

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

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

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.

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.