Instalação offline de Azure PowerShell

Em alguns ambientes, não é possível ligar-se à internet ou à Galeria do PowerShell. Nessas situações, você pode instalar o módulo Az PowerShell offline usando um desses métodos.

Observação

As opções de instalação offline neste artigo exigem pelo menos um sistema com acesso à Internet para baixar o módulo Az PowerShell, que pode ser diferente do sistema onde você planeja instalar o módulo.

Pré-requisitos

  • Instalar uma versão suportada do PowerShell versão 7 ou superior
  • O Windows PowerShell 5.1 também é suportado se estiver a usar um sistema operativo Windows.

Multiplataforma

As seguintes opções de instalação para o módulo Az PowerShell estão disponíveis multiplataforma em todas as plataformas, incluindo Windows, Linux e macOS.

Instalar a partir do arquivo tar

Sugestão

O tar utilitário de linha de comando é necessário para usar essa opção de instalação. Está disponível por defeito no Windows 10 versão 1803 ou superior, na maioria das distribuições Linux e nas versões atuais do macOS.

  1. Em um sistema com acesso à internet, defina o caminho de destino onde deseja salvar o arquivo tar.

    $downloadFolderPath = "$home/Downloads"

  2. Verifique se a pasta de download existe. Crie a pasta caso contrário.

    if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
    New-Item -Path $downloadFolderPath -ItemType Directory
}

  3. Determine a URL do arquivo tar da versão mais recente do módulo Az PowerShell no GitHub.

    $tarSourceUrl = (
    Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
    Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
).browser_download_url

  4. Armazene o nome do arquivo tar e o caminho do arquivo de destino em variáveis.

    $fileName = Split-Path -Path $tarSourceUrl -Leaf
$downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName

  5. Descarregue o arquivo tar do GitHub usando PowerShell.

    Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

  6. Desbloqueie o ficheiro descarregado se estiver a usar um sistema operativo Windows.

    if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}

    Observação

    Copie o arquivo tar para o seu sistema offline. Defina as $downloadFilePath variáveis e $downloadFolderPath ou especifique valores reais em vez de usar as variáveis nos comandos a seguir em seu sistema offline.

  7. Extraia o conteúdo do arquivo tar.

    tar zxf $downloadFilePath -C $downloadFolderPath

  8. Execute o InstallModule.ps1 script que é um dos arquivos extraídos no sistema offline onde você deseja instalar o módulo Az PowerShell.

    .$downloadFolderPath/InstallModule.ps1

Salvar e copiar a instalação

Descarregue o módulo Az PowerShell com Save-Module ou Save-PSResource para uma localização de rede, usando um sistema com acesso à internet e à Galeria do PowerShell. Esses comandos salvam o módulo Az e suas dependências no local especificado. Use os módulos salvos como fonte de instalação e copie-os para o sistema offline.

Instalar a partir de um repositório privado

Crie um repositório privado na sua rede local e use-o como fonte de instalação para o seu sistema offline. Para saber mais, consulte Trabalhando com repositórios privados do PowerShellGet.

Este método permite armazenar em cache módulos PowerShell num único servidor ou partilha de ficheiros para serem implementados com PowerShellGet ou Microsoft. PowerShell.PSResourceGet para quaisquer sistemas desligados.

Windows

No Windows, também tens a opção de instalar o módulo Az PowerShell com um MSI se estiveres a usar o PowerShell do Windows versão 5.1.

Importante

Lembra-te que o instalador MSI só funciona para o PowerShell 5.1 do Windows.

Troubleshooting

Para obter soluções para problemas comuns de instalação com o módulo Az PowerShell, consulte Solucionar problemas de instalação com o módulo Az PowerShell.

Consulte também

Próximas Etapas

Para saber mais sobre a gestão dos seus recursos de Azure com o módulo Az PowerShell, consulte Comece com Azure PowerShell.

  • Last updated on