Instalação offline do Azure PowerShell

Artigo
01/15/2025

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.

Multiplataforma

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

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 Linux e nas versões atuais do macOS.

Em um sistema com acesso à internet, defina o caminho de destino onde deseja salvar o arquivo 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 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 do 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 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 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 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.

Este método permite armazenar em cache módulos do PowerShell num único servidor ou numa partilha de ficheiros de modo a poderem ser implantados com o 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.

Instale o Azure PowerShell no Windows com o MSI Installer.

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.

Ver também

Próximos passos

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

Partilhar via