Instalar o Azure PowerShellInstall Azure PowerShell

Este artigo explica como instalar os módulos do Azure PowerShell usando o PowerShellGet.This article explains how to install the Azure PowerShell modules using PowerShellGet. Essas 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 agora é pré-instalado em imagens do Docker.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

RequisitosRequirements

Observação

O PowerShell 7.x e posterior é a versão recomendada do PowerShell para uso com Azure PowerShell em todas as plataformas.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 posterior em todas as plataformas.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. Ele também é compatível 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 seu sistema operacional.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 posterior.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

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

$PSVersionTable.PSVersion

Para usar 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 você está usando o Windows 10 versão 1607 ou superior, você 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 módulo do Azure PowerShellInstall the Azure PowerShell module

Aviso

Não há compatibilidade na instalação dos módulos AzureRM e Az no PowerShell 5.1 para Windows ao mesmo tempo.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. Caso você precise manter o AzureRM disponível no sistema, instale o módulo Az para o PowerShell 6.2.4.x ou posterior.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

O uso dos cmdlets do PowerShellGet é o método de instalação preferencial.Using the PowerShellGet cmdlets is the preferred installation method. Instale o módulo Az somente para o usuário atual.Install the Az module for the current user only. Este é o escopo de instalação recomendado.This is the recommended installation scope. Esse 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 em 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 padrão, a galeria do PowerShell não está configurada como um repositório confiável para o PowerShellGet.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. Na primeira vez em que a PSGallery for utilizada, o prompt a seguir será exibido: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 a instalação.Answer Yes or Yes to All to continue with the installation.

A instalação do módulo para todos os usuários de um sistema requer privilégios elevados.Installing the module for all users on a system requires elevated privileges. Inicie a sessão do PowerShell usando Executar como administrador no Windows ou use 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 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 dele baixa todos os módulos em disponibilidade geral do Az Powershell e possibilita usar seus cmdlets.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 se conectar à Galeria do PowerShell.In some environments, it's not possible to connect to the PowerShell Gallery. Nessas situações, você ainda pode instalar offline usando um destes métodos:In those situations, you can still install offline using one of these methods:

  • Baixe os módulos em outro local da sua rede e use-os como uma origem de instalação.Download the modules to another location in your network and use that as an installation source. Esse método permite que você armazene módulos do PowerShell em cache em um único servidor ou compartilhamento de arquivo para serem implantados com o PowerShellGet em sistemas desconectados.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 desconectados com Trabalhar com repositórios PowerShellGet locais.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • Baixe o MSI (Microsoft Windows Installer) do Azure PowerShell em um computador conectado à rede e, em seguida, copie o instalador para sistemas sem 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 do MSI só funciona para PowerShell 5.1 no Windows.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Salve o módulo com Save-Module em um compartilhamento de arquivo ou salve-o em outra fonte e copie-o 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
    

Solução de problemasTroubleshooting

Estes são alguns problemas comuns observados durante a instalação do módulo do Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Caso você tenha um problema que não foi listado aqui, registre um problema no GitHub.If you experience a problem not listed here, file an issue on GitHub.

Conexão de blocos de proxyProxy blocks connection

Se você obtiver erros de Install-Module que indicam que a Galeria do PowerShell está inacessível, talvez você esteja protegido por um proxy.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Sistemas operacionais e ambientes de rede diferentes têm requisitos diferentes para configurar um proxy para todo o sistema.Different operating systems and network environment have different requirements for configuring a system-wide proxy. Entre em contato com o administrador do sistema para obter as configurações de proxy e saber como defini-las para seu ambiente.Contact your system administrator for your proxy settings and how to configure them for your environment.

O PowerShell em si pode não ser configurado para usar esse proxy automaticamente.PowerShell itself may not be configured to use this proxy automatically. Com o PowerShell 5.1 e posterior, configure a sessão do PowerShell para usar um proxy por meio dos seguintes comandos: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

Caso suas credenciais do sistema operacional estejam configuradas corretamente, essa configuração roteará as solicitações do PowerShell por meio do proxy.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. Para manter essa configuração entre as 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 precisa permitir conexões HTTPS com o seguinte endereço:To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

EntrarSign in

Para começar a trabalhar com o Azure PowerShell, entre com 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

Observação

Se você desabilitou o carregamento automático do módulo, importe manualmente o módulo com Import-Module -Name Az.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. Por causa da maneira como o módulo está estruturado, isso pode levar alguns segundos.Because of the way the module is structured, this can take a few seconds.

Será necessário repetir essas etapas para cada sessão nova do PowerShell que você iniciar.You'll need to repeat these steps for every new PowerShell session you start. 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.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, você deve usar o mesmo método usado para instalar o módulo.To update any PowerShell module, you should use the same method used to install the module. Por exemplo, caso tenha usado Install-Module originalmente, você deverá usar 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. Caso tenha usado originalmente o pacote MSI, você deverá baixar 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 podem atualizar os módulos que foram instalados por meio de um pacote MSI.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. Os pacotes MSI não atualizam módulos que foram instalados usando o PowerShellGet.MSI packages do not update modules that were installed using PowerShellGet. Se você tiver problemas ao atualizar usando o PowershellGet, deverá reinstalar em vez de atualizar.If you have any issues updating using PowershellGet, then you should reinstall , rather than update. A reinstalação é feita da mesma forma que a instalação, mas você precisa 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
}

Diferentemente das instalações baseadas em MSI, instalar ou atualizar usando o PowerShellGet não remove as versões mais antigas que possam existir em 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 sistema, confira 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, consulte Instalar o Azure PowerShell com um MSI.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

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

É possível instalar mais de uma versão do Azure PowerShell.It's possible to install more than one version of Azure PowerShell. Para verificar se você tem diversas versões do Azure PowerShell instaladas, use 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, confira Desinstalar módulo do Azure PowerShell.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Se você tiver mais de uma versão do módulo instalada, o carregamento automático do módulo e o Import-Module carregarão a versão mais recente por padrão.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

Você pode instalar ou carregar uma versão específica do módulo Az usando 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

Usar vários repositórios com o PowerShellGetUse multiple repositories with PowerShellGet

O parâmetro Repository será necessário se você tiver adicionado repositórios adicionais ao PowerShellGet no seu sistema e o módulo Az puder ser encontrado em mais de um deles.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
}

Fornecer comentáriosProvide feedback

Se você encontrar um bug no Azure PowerShell, registre o problema no GitHub.If you find a bug in Azure PowerShell, file an issue on GitHub. Para fazer comentários na linha de comando, use o cmdlet Send-Feedback.To provide feedback from the command line, use the Send-Feedback cmdlet.

Próximas etapasNext Steps

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