Installazione offline di Azure PowerShell

Articolo
01/15/2025

In alcuni ambienti non è possibile connettersi a Internet o a PowerShell Gallery. In queste situazioni, è possibile installare il modulo Az PowerShell offline usando uno di questi metodi.

Nota

Le opzioni per l'installazione offline in questo articolo richiedono almeno un sistema con accesso a Internet per scaricare il modulo Az PowerShell , che può essere diverso dal sistema in cui si prevede di installare il modulo.

Prerequisiti

Installare una versione supportata di PowerShell versione 7 o successiva
Windows PowerShell 5.1 è supportato anche se si esegue un sistema operativo Windows.

Multipiattaforma

Le opzioni di installazione seguenti per il modulo Az PowerShell sono disponibili multipiattaforma in tutte le piattaforme, tra cui Windows, Linux e macOS.

Installare dall'archivio tar

Mancia

L'utilità della riga di comando tar è necessaria per usare questa opzione di installazione. È disponibile per impostazione predefinita in Windows 10 versione 1803 o successiva, nella maggior parte delle distribuzioni Linux e nelle versioni correnti di macOS.

In un sistema con accesso a Internet definire il percorso di destinazione in cui si vuole salvare l'archivio tar.
```
$downloadFolderPath = "$home/Downloads"
```

Verificare che la cartella di download esista. Creare la cartella in caso contrario.

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

Determinare l'URL dell'archivio tar per la versione più recente del modulo Az PowerShell in 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

Archiviare il nome file tar e il percorso file di destinazione nelle variabili.

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

Scaricare l'archivio tar da GitHub usando PowerShell.

Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

Sbloccare il file scaricato se si esegue un sistema operativo Windows.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
Nota

Copiare l'archivio tar nel sistema offline. Definire le variabili $downloadFilePath e $downloadFolderPath oppure specificare valori effettivi anziché usare le variabili nei comandi seguenti nel sistema offline.

Estrarre il contenuto dell'archivio tar.

tar zxf $downloadFilePath -C $downloadFolderPath

Eseguire lo script InstallModule.ps1 che è uno dei file estratti nel sistema offline in cui si vuole installare il modulo Az PowerShell.
```
.$downloadFolderPath/InstallModule.ps1
```

Salvare e copiare l'installazione

Scaricare il modulo Az PowerShell con Save-Module o Save-PSResource in un percorso di rete utilizzando un sistema con accesso a Internet e alla PowerShell Gallery. Questi comandi salvano il modulo Az e le relative dipendenze nel percorso specificato. Usare i moduli salvati come origine di installazione e copiarli nel sistema offline.

Eseguire l'installazione da un repository privato

Creare un repository privato nella rete locale e usarlo come fonte di installazione per il sistema offline. Per ulteriori informazioni, vedere Lavorare con i repository privati di PowerShellGet.

Questo metodo consente di memorizzare nella cache i moduli di PowerShell in un singolo server o in una condivisione file da distribuire con PowerShellGet o Microsoft.PowerShell.PSResourceGet a qualsiasi sistema disconnesso.

Windows

In Windows è anche possibile installare il modulo Az PowerShell tramite un pacchetto MSI se si utilizza Windows PowerShell versione 5.1.

Importante

Tenere presente che il programma di installazione MSI funziona solo per Windows PowerShell 5.1.

Installare Azure PowerShell in Windows con il programma di installazione MSI.

Risoluzione dei problemi

Per soluzioni ai problemi di installazione comuni con il modulo Az PowerShell, vedere Risolvere i problemi di installazione con il modulo Az PowerShell.

Vedere anche

Passaggi successivi

Per altre informazioni sulla gestione delle risorse di Azure con il modulo Az PowerShell, vedere Introduzione ad Azure PowerShell.

Condividi tramite