Ler em inglês

Compartilhar via


Instalação offline do Azure PowerShell

Em alguns ambientes, não é possível se conectar à internet ou à Galeria do PowerShell. Nessas situações, você ainda 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 em que você planeja instalar o módulo.

Pré-requisitos

  • Instalar uma versão compatível do PowerShell 7 ou superior
  • O Windows PowerShell 5.1 também terá suporte se você estiver executando um sistema operacional Windows.

Plataforma cruzada

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

Instalar a partir dos arquivos tar

Dica

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

  1. Em um sistema com acesso à internet, defina o caminho de destino em que você deseja salvar os arquivos tar.

    PowerShell
    $downloadFolderPath = "$home/Downloads"
    
  2. Verifique se a pasta de download existe. Crie a pasta caso contrário.

    PowerShell
    if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
        New-Item -Path $downloadFolderPath -ItemType Directory
    }
    
  3. Determine a URL dos arquivos tar para a versão mais recente do módulo do Az PowerShell no GitHub.

    PowerShell
    $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 dos arquivos tar e o caminho de arquivo de destino em variáveis.

    PowerShell
    $fileName = Split-Path -Path $tarSourceUrl -Leaf
    $downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName
    
  5. Baixe os arquivos tar do GitHub usando o PowerShell.

    PowerShell
    Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
    
  6. Desbloqueie o arquivo baixado se você estiver executando um sistema operacional Windows.

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

    Observação

    Copie os arquivos tar para seu sistema offline. Defina as variáveis $downloadFilePath 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 dos arquivos tar.

    PowerShell
    tar zxf $downloadFilePath -C $downloadFolderPath
    
  8. Execute o script InstallModule.ps1 que é um dos arquivos extraídos no sistema offline em que você deseja instalar o módulo do Az PowerShell.

    PowerShell
    .$downloadFolderPath/InstallModule.ps1
    

Salvar e copiar a instalação

Baixe o módulo do 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 a origem da instalação e copie-os para o sistema offline.

Instalar de um repositório privado

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

Esse método permite que você armazene módulos do PowerShell em cache em um único servidor ou compartilhamento de arquivo para serem implantados com o PowerShellGet ou Microsoft.PowerShell.PSResourceGet em sistemas desconectados.

Windows

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

Importante

Tenha em mente 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 do módulo Az do PowerShell, confira Solucionar problemas de instalação do módulo Az do PowerShell.

Confira também

Próximas etapas

Para saber como gerenciar os recursos do Azure com o módulo Az do PowerShell, confira Introdução ao Azure PowerShell.