Instalação offline do Azure PowerShell

Artigo
03/07/2025

Em alguns ambientes, não é possível se conectar à Internet ou à Galeria do PowerShell. Nessas situações, você pode instalar o módulo do 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 com suporte do PowerShell versão 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 do arquivo 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 superior, na maioria das distribuições do Linux e nas versões atuais do macOS.

Em um sistema com acesso à Internet, defina o caminho de destino em que você deseja salvar o arquivo de tar.
```
$downloadFolderPath = "$home/Downloads"
```

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
}

Determine a URL do arquivo tar para a versão mais recente do módulo do 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

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

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

Baixe o arquivo tar do GitHub usando o PowerShell.

Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

Desbloqueie o arquivo baixado se você estiver executando um sistema operacional Windows.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
Observação

Copie o arquivo 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.

Extraia o conteúdo do arquivo tar.

tar zxf $downloadFilePath -C $downloadFolderPath

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.
```
.$downloadFolderPath/InstallModule.ps1
```

Salvar e copiar a instalação

Baixe o módulo do Az PowerShell com Save-Module ou Save-PSResource em 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 em 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 o Windows PowerShell versão 5.1.

Importante

Tenha em mente que o instalador msi só funciona para o Windows PowerShell 5.1.

Instalar o Azure PowerShell no Windows com o Instalador MSI.

Resolução de problemas

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

Consulte também

Próximas etapas

Para saber mais sobre como gerenciar seus recursos do Azure com o módulo do Az PowerShell, consulte Introdução ao Azure PowerShell.

Compartilhar via