Instale o módulo Azure Az PowerShell

Este artigo explica como instalar o módulo Azure Az PowerShell a partir do Galeria do PowerShell. Estas instruções funcionam nas plataformas Windows, Linux e macOS.

O módulo Azure Az PowerShell está pré-instalado em Azure Cloud Shell e em imagens Docker.

O módulo Azure Az PowerShell é um módulo rollup. A instalação descarrega os módulos Az PowerShell geralmente disponíveis e disponibiliza os seus cmdlets para utilização.

Requisitos

Nota

PowerShell 7.0.6 LTS, PowerShell 7.1.3 ou superior é a versão recomendada do PowerShell para utilização com o módulo Azure Az PowerShell em todas as plataformas.

Azure PowerShell não tem requisitos adicionais quando funciona no PowerShell 7.0.6 LTS e PowerShell 7.1.3 ou superior.

• Instale a versão mais recente do PowerShell disponível para o seu sistema operativo.

Para verificar a sua versão PowerShell, executar o seguinte comando a partir de uma sessão PowerShell:

$PSVersionTable.PSVersion

A política de execução do guião PowerShell deve ser definida para assinada remotamente ou menos restritiva. Get-ExecutionPolicy -List pode ser usado para determinar a política de execução atual. Para mais informações, consulte about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalação

A utilização do cmdlet install-module é o método de instalação preferido para o módulo Az PowerShell. Instale o módulo do Az apenas no utilizador atual. Este é o âmbito de instalação recomendado. Este método funciona da mesma forma nas plataformas Windows, Linux e macOS. 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

Enquanto o PowerShell 7.0.6 LTS, PowerShell 7.1.3 ou superior é a versão recomendada do PowerShell, e Install-Module é a opção de instalação recomendada, existem opções de instalação adicionais, se necessário.

Instalação em Windows PowerShell

Importante

Se tiver o módulo AzureRM PowerShell instalado, consulte a coexistência Az e AzureRM antes de prosseguir.

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. Atualize para o Windows PowerShell 5.1. Se utilizar o Windows 10, versão 1607 ou superior, já tem o PowerShell 5.1 instalado.
2. Instale o .NET Framework 4.7.2 ou posterior.
3. Verifique se tem a versão mais recente do PowerShellGet. Execute 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 utilizando um destes métodos:

• Descarregue o MSI Azure PowerShell. Tenha em mente que o instalador MSI funciona apenas 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 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. Saiba como configurar um repositório local e instalar em sistemas desligados com a opção Trabalhar com repositórios do PowerShellGet locais.
• Guarde o módulo com o Módulo De Salvamento para uma partilha de ficheiros, ou guarde-o para outra fonte e copie-o manualmente para outras máquinas.

Iniciar sessão

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

Connect-AzAccount

Depois de executar este comando, uma nova janela do navegador aparece e pode iniciar sessão na sua conta Azure.

Atualizar o módulo do Azure PowerShell

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

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

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.

Nota

A desinstalação pode ser complicada se tiver mais de uma versão do módulo Az PowerShell instalada. Devido a esta complexidade, apenas suportamos a desinstalação de todas as versões do módulo Az PowerShell que estão atualmente instaladas.

Para remover todas as versões do módulo Az PowerShell do seu sistema, consulte Desinstalar o módulo Azure PowerShell. Para obter mais informações sobre instalações baseadas em MSI, veja Instalar o Azure PowerShell com um MSI.

Resolução de problemas

Problemas de instalação de resolução de problemas com o módulo Azure Az PowerShell.

Enviar comentários

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

Passos Seguintes

Para saber mais sobre os módulos Azure Az PowerShell e suas funcionalidades, consulte 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.