Instalar módulo do Azure PowerShellInstall the Azure PowerShell module

Este artigo informa como instalar os módulos do Azure PowerShell usando o PowerShellGet.This article tells you 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. Para o módulo Az, atualmente não há suporte para outros métodos de instalação.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 você não tiver certeza se tem o PowerShell ou se está no macOS ou no Linux, instale a última versão 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 verificar 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 necessário.Update to Windows PowerShell 5.1 if needed. Se você estiver usando o Windows 10, você 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 há nenhum requisito adicional para o Azure PowerShell ao usar o PowerShell Core.There are no additional requirements for Azure PowerShell when using PowerShell Core.

Instalar módulo do Azure PowerShellInstall the Azure PowerShell module

Aviso

Não é possível instalar os módulos AzureRM e Az para o PowerShell 5.1 para Windows ao mesmo tempo.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Caso você precise manter o AzureRM disponível no sistema, instale o módulo 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 fazer isso, instale o PowerShell Core 6.x ou posterior e, depois, siga estas instruções em um terminal do PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

O método de instalação recomendado deve apenas ser instalado para o usuário ativo:The recommended install method is to only install for the active user:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Se desejar instalar para todos os usuários em um sistema, isso requererá privilégios de administrador.If you want to install for all users on a system, this requires administrator privileges. Em uma sessão do PowerShell com privilégios elevados executada como administrador ou com o comando sudo em macOS ou Linux:From an elevated PowerShell session either run as administrator or with the sudo command on macOS or Linux:

Install-Module -Name Az -AllowClobber -Scope AllUsers

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.

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 disponíveis do Azure Resource Manager e possibilita usar seus cmdlets.Installing it downloads all of the available Azure Resource Manager 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 para outro local e use-o como uma origem de instalação em sua rede.Download the modules to another location and use that as an installation source on your network. Isso pode ser um processo complicado, mas permitirá 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 can be a complicated process, but will let you 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 '\\someshare\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, please 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 diferentes terão requisitos diferentes para configurar um proxy de todo o sistema, que não são abordados detalhadamente aqui.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Entre em contato com o administrador do sistema para obter as configurações de proxy e saber como defini-las para seu sistema operacional.Contact your system administrator for your proxy settings and how to configure them for your OS.

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 o proxy a ser usado para uma 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

Caso suas credenciais do sistema operacional estejam configuradas corretamente, isso roteará as solicitações do PowerShell por meio do proxy.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Para manter essa configuração entre as 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 precisa permitir conexões HTTPS para o seguinte endereço:In order 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 Az.If you've disabled module autoloading, manually import the module with Import-Module 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

Devido ao modo de empacotamento do módulo Az, o comando Update-Module não atualizará a instalação corretamente.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. Quando você instala o módulo Az, na verdade, ele coleta e instala todos os submódulos dependentes e que fornecem os cmdlets para cada serviço.When you install the Az module, it actually collects and installs all of its dependent submodules, and which provide the cmdlets for each service. Isso significa que, para atualizar o módulo do Azure PowerShell, você precisará fazer uma reinstalação, em vez de apenas uma atualização.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Isso é feito da mesma forma que a instalação, mas talvez você precise 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 isso possa substituir os módulos instalados, você ainda poderá ter versões mais antigas no sistema.Although this can overwrite installed modules, you may still have older versions left on your system. Para saber como remover as versões antigas do Azure PowerShell do sistema, confira 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.

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

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

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.