Instalar o módulo Azure Az PowerShell

Este artigo explica como instalar o módulo Azure Az PowerShell através do PowerShellGet. Estas instruções funcionam em Windows, macOS e Linux.

O módulo Azure Az PowerShell é pré-instalado na Shell da Nuvem do Azure e em imagens do Docker.

O módulo Azure Az PowerShell é um módulo de rollup. Ao instalá-lo, transfere os módulos do Az PowerShell disponíveis para utilização geral e disponibiliza os respetivos cmdlets.

Requisitos

Nota

O PowerShell 7.x e posterior é a versão recomendada do PowerShell para utilização com o módulo Azure Az PowerShell em todas as plataformas.

O módulo Azure Az PowerShell funciona com o PowerShell 7.x e posterior em todas as plataformas. Azure PowerShell não tiver requisitos adicionais quando executado no PowerShell 7.x e posterior.

Para verificar a sua versão do PowerShell, execute o seguinte comando numa sessão do PowerShell:

$PSVersionTable.PSVersion

A política de execução de scripts do PowerShell tem de ser definida para assinatura remota ou menos restritiva. Get-ExecutionPolicy -List podem ser utilizadas para determinar a política de execução atual. Para obter mais informações, consulte o about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalação

Utilizar o cmdlet Install-Module é o método de instalação preferencial para o módulo Az PowerShell. Instale o módulo Az apenas para o utilizador atual. Este é o âmbito de instalação recomendado. Este método funciona da mesma forma em Windows, macOS e Linux. Execute o seguinte comando a partir de uma sessão do PowerShell:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Outras Opções de Instalação

Embora o PowerShell 7.x seja a versão recomendada do PowerShell e seja a opção de instalação recomendada, existem opções de Install-Module instalação adicionais, se necessário.

Instalação no Windows PowerShell

O módulo Azure Az PowerShell também é suportado para utilização com o PowerShell 5.1 no Windows. Para utilizar o módulo Azure Az PowerShell no PowerShell 5.1 no Windows:

  1. Atualização para Windows PowerShell 5.1. Se estiver a trabalhar Windows 10 1607 ou superior, já tem o PowerShell 5.1 instalado.
  2. Instale .NET Framework 4.7.2 ou posterior.
  3. Certifique-se de que tem a versão mais recente do PowerShellGet. Executar Install-Module -Name PowerShellGet -Force .

Instalação Offline

Em alguns ambientes, não é possível ligar à Galeria do PowerShell. Nestas situações, pode instalar o módulo Az PowerShell offline através de um destes métodos:

  • Transfira o Azure PowerShell MSI. Tenha em atenção que o instalador MSI só funciona para o PowerShell 5.1 no Windows.
  • Transfira os módulos para outra localização na sua rede e utilize-os como uma origem de instalação. Este método permite-lhe implementar módulos do PowerShell em cache num único servidor ou partilha de ficheiros com o PowerShellGet em todos os sistemas desligados. Saiba como configurar um repositório local e instalar em sistemas desligados com a ação de Trabalhar com o PowerShell localOcebe repositórios.
  • Guarde o módulo com Guardar Módulo numa partilha de ficheiros ou guarde-o noutra origem e copie-o manualmente para outros máquinas.

Inscrever-se

Para começar a trabalhar com Azure PowerShell, inicie a ação com as suas credenciais do Azure.

Connect-AzAccount

Após executar este comando, é aberta uma nova janela do browser e pode iniciar sessão na sua conta do Azure.

Atualizar o Azure PowerShell de atualizações

Para atualizar qualquer módulo do PowerShell, deve utilizar o mesmo método utilizado para instalar o módulo. Por exemplo, se utilizava originalmente Install-Module , deve utilizar Update-Module para obter a versão mais recente. Se tiver utilizado originalmente o pacote MSI, deve transferir e instalar o novo pacote MSI.

Os cmdlets do PowerShellGet não podem atualizar módulos instalados a partir de um pacote MSI. Os pacotes MSI não atualizam módulos instalados com o PowerShellGet. Se tiver problemas com a atualização através do PowerShellGet, deve reinstalar, em vez de atualizar. A reinstalação é feita da mesma forma que a instalação. Certifique-se de Force que utiliza o parâmetro com o de Install-Module reinstalação.

Ao contrário das instalações baseadas em MSI, a instalação ou atualização através do PowerShellGet não remove versões mais antigas que possam existir no seu sistema. Para remover versões antigas do módulo Az PowerShell do seu sistema, consulte Desinstalar o módulo Azure PowerShell do Az. Para obter mais informações sobre instalações baseadas em MSI, consulte Instalar Azure PowerShell com um MSI.

Remoção de Problemas

Eis alguns problemas comuns que se detetam ao instalar o módulo Azure Az PowerShell. Se tiver um problema não listado aqui, arquivar um problema no GitHub.

Coexistência com OZ e AzureRM

Aviso

Não suportamos ter os módulos AzureRM e Az instalados para o PowerShell 5.1 no Windows ao mesmo tempo.

Num cenário em que queira instalar o AzureRM e o módulo Az PowerShell no mesmo sistema, o AzureRM só tem de ser instalado no âmbito de utilizador Windows PowerShell. Instale o módulo Az PowerShell para PowerShell 7.x no mesmo sistema.

Importante

Como os módulos Az PowerShell têm agora todas as funcionalidades dos módulos AzureRM PowerShell e muito mais, iremos retirar os módulos do PowerShell do AzureRM a 29 de fevereiro de 2024.

Para evitar interrupções de serviço, atualize os seus scripts que utilizam módulos do PowerShell do AzureRM para utilizar módulos Az PowerShell até 29 de fevereiro de 2024. Para atualizar automaticamente os seus scripts, siga o guia de guia de instruções rápida.

Proxy bloqueia a ligação

Se obteve erros a partir da galeria do PowerShell não é possível obter, poderá Install-Module estar atrás de um proxy. Sistemas operativos e ambiente de rede diferentes têm requisitos diferentes para configurar um proxy de todo sistema. Contacte o administrador de sistema para saber as suas definições de proxy e como configurá-las para o seu ambiente.

O PowerShell poderá não estar configurado para utilizar este proxy automaticamente. Com o PowerShell 5.1 e posterior, configure a sessão do PowerShell para utilizar um proxy com os seguintes comandos:

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

Se as credenciais do seu sistema operativo estiverem configuradas corretamente, esta configuração encaminho os pedidos do PowerShell através do proxy. Para que esta definição persista entre sessões, adicione os comandos ao seu perfil do PowerShell.

Para instalar o pacote, o proxy tem de permitir ligações HTTPS ao https://www.powershellgallery.com .

Fornecer comentários

Se encontrar um erro no módulo Azure Az PowerShell, arquive um problema no GitHub. Para fornecer feedback a partir de uma sessão do PowerShell, utilize o cmdlet Send-Feedback.

Passos Seguintes

Para saber mais sobre os módulos do PowerShell do Azure Az e as respetivas funcionalidades, consulte o Introdução com Azure PowerShell. Se estiver familiarizado com o Azure PowerShell e precisar de migrar a partir do AzureRM, consulte Migrar do AzureRM para o Az.