• 05/14/2020
• 6 minutos para ler
• • m
  • h

Este artigo explica como instalar o Azure PowerShell módulos usingPowerShellGet. Estas instruções funcionam em plataformas Windows, macOS e Linux.

Azure PowerShell is also available in Azure Cloud Shell and is nowpreinstalled in Docker images.

Requisitos

Azure PowerShell funciona com PowerShell 6.2.4 e mais tarde em todas as plataformas. Ele também é suportado com powowershell 5.1 no Windows. Instale a versão mais recente do PowerShell disponível para o seu sistema operativo. Azure PowerShell não tem requisitos adicionais quando executado em PowerShell 6.2.4 e mais tarde.

Para verificar o seu PowerShell versão, execute o comando:

$PSVersionTable.PSVersion

Para usar o Azure PowerShell no PowerShell 5.1 no Windows:

1. Atualização para owindows PowerShell 5.1.,Se você estiver no Windows 10 Versão 1607 ou superior, você já tem PowerShell 5.1 instalado.
2. Install. NET Framework 4.7.2 ou mais tarde.
3. certifique-se que tem a última versão do PowerShellGet. Run Install-Module -Name PowerShellGet -Force.

Instale o módulo Azure PowerShell

Install for Current User

Using the PowerShellGet cmdlets is the preferred installation method. Instale o módulo Az apenas para o utilizador actual. Este é o escopo de instalação recomendado. Este método funciona as mesmas plataformas onWindows, macOS e Linux. Execute o seguinte comando a partir de uma sessão PowerShell:

Por omissão, a galeria PowerShell não está configurada como um repositório de confiança para o PowerShellGet., Primeira vez que você usar o PSGallery você verá a seguinte linha de comandos:

Resposta Yes ou Yes to All para continuar com a instalação.

Instalar para todos os utilizadores

Instalar o módulo para todos os utilizadores num sistema requer privilégios elevados. Inicie a sessão PowerShellsession usando a execução como administrador no Windows ou use o sudo comando em macOS ou Linux:

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

instale offline

em alguns ambientes, não é possível conectar-se à galeria PowerShell. Nessas situações, você ainda pode instalar offline usando um desses métodos:

• baixar os módulos para outro local em sua rede e usá-lo como fonte de instalação.Este método permite que você cache módulos PowerShell em um único servidor ou compartilhamento de arquivos para ser implantado com PowerShellGet para qualquer sistema desconectado., Aprenda como configurar um repositório local e instalar sistemas desligados com o trabalho com repositórios de itens PowerShell locais.

• descarregue a Azure PowerShell MSI para uma máquina ligada à rede,e depois copie o instalador para sistemas sem acesso à galeria PowerShell. Tenha em mente que o instalador theMSI só funciona para PowerShell 5.1 no Windows.,

• Salve o módulo com a opção ” Salvar-Módulo para um compartilhamento de arquivo ou salvá-lo para outra fonte e copiar manualmente para outras máquinas:

  Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force

Resolução de problemas

Aqui estão alguns problemas comuns visto quando instalar o Azure PowerShell módulo. Se você experimentar um problema não listado aqui, coloque um problema no GitHub.

o Proxy bloqueia a ligação

Se tiver erros de Install-Module que indicam que a Galeria PowerShell está inacessível, você pode estar por trás de um proxy., Os diferentes sistemas operativos e o ambiente de rede têm diferentes requisitos para configurar um proxy à escala do sistema. Contacte o seu administrador de sistema para as suas opções de ‘proxy’ e como configurá-las para o seu ambiente.

PowerShell em si não pode ser configurada para usar este proxy automaticamente. Com o PowerShell 5.1 andlater, configure a sessão PowerShell para usar um ‘proxy’ usando os seguintes comandos:

Se as suas credenciais do sistema operativo estiverem configuradas correctamente, esta configuração encaminha os ‘PowerShell’ através do ‘proxy’., Para que esta configuração persista entre sessões, adicione os comandos ao seu perfil de powershell.

para instalar o pacote, o seu ‘proxy’ necessita de permitir ligações HTTPS para o seguinte endereço:

Sign in

To start working with Azure PowerShell, sign in with your Azure credentials.

terá de repetir estes passos para cada nova sessão PowerShell que iniciar. Para saber como o topersist seu signo Azure em todas as sessões PowerShell, veja as credenciais de usuário persist em todas as sessões PowerShell.,

actualize o módulo PowerShell Azure

para actualizar qualquer módulo PowerShell, deverá usar o mesmo método utilizado para instalar o módulo. Por exemplo, se usou originalmente Install-Module, então deve usar o módulo de actualização para obter a versão mais recente. Se você originalmente usou o pacote MSI, então você deve baixar e instalar o novo pacote MSI.

os cmdlets PowerShellGet não podem actualizar os módulos que foram instalados a partir de um pacote MSI. Os MSIpackages não atualizam módulos que foram instalados usando PowerShellGet., Se você tiver algum problema updating usando PowershellGet, então você deve reinstalar, em vez de atualizar. Reinstalar o isdone da mesma forma que instalar, mas você precisa adicionar o id

parâmetro:

Ao contrário das instalações baseadas no MSI, a instalação ou actualização usando o PowerShellGet não remove as versões que possam existir no seu sistema. Para remover versões antigas do Azure PowerShell do seu sistema,veja desinstalar o módulo Azure PowerShell. Para mais informações sobre as instalações baseadas no MSI, consulte Instalar Azure PowerShell com um MSI.,

Use múltiplas versões do Azure PowerShell

é possível instalar mais de uma versão do Azure PowerShell. Para verificar se tem multipleversões do Azure PowerShell instaladas, use o seguinte comando:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Para remover uma versão do Azure PowerShell, veja desinstalar o módulo Azure PowerShell.

Se tiver mais do que uma versão do módulo instalado, módulo autoload e Import-Module carregar a última versão por omissão.,

Você pode instalar ou carregar uma versão específica de Az módulo usando o -RequiredVersionparâmetro:

o Uso de múltiplos repositórios com PowerShellGet

O Repositório parâmetro será necessário se você tiver adicionado repositórios adicionais para PowerShellGeton seu sistema e o Az módulo pode ser encontrado em mais de um deles.

forneça feedback

Se encontrar um erro no PowerShell Azure, envie um problema para o GitHub. Para fornecer o feedback a partir da linha de comandos, utilize o cmdlet de envio-Feedback.,

para saber mais sobre os módulos PowerShell Azure e suas características, seeGet começou com Azure PowerShell. Se você está familiarizado com AzurePowerShell e precisa migrar de AzureRM, seeMigrate de AzureRM para Az.