Instalação offline do Azure PowerShell

Em alguns ambientes, não é possível conectar-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 você estiver executando um sistema operacional Windows.

Várias plataformas

As seguintes opções de instalação para o módulo Az PowerShell estão disponíveis entre plataformas 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 padrão 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 para a 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. Baixe o arquivo tar do GitHub usando o PowerShell.

    Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

  6. Desbloqueie o ficheiro transferido se estiver a executar 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

Baixe o módulo Az PowerShell com Save-Module ou Save-PSResource para um local 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.

Esse método permite armazenar em cache módulos do PowerShell em um único servidor ou compartilhamento de arquivos a ser implantado com PowerShellGet ou Microsoft.PowerShell.PSResourceGet em qualquer sistema desconectado.

Windows

No Windows, você também tem a opção de instalar o módulo Az PowerShell com um MSI se estiver usando o Windows PowerShell versão 5.1.

Importante

Lembre-se de que o instalador MSI só funciona para o Windows PowerShell 5.1.

Solução de problemas

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 como gerenciar seus recursos do Azure com o módulo Az PowerShell, consulte Introdução ao Azure PowerShell.

  • Last updated on