Offlineinstallation von Azure PowerShell

Artikel
01/16/2025

In einigen Umgebungen ist es nicht möglich, eine Verbindung mit dem Internet oder der PowerShell Gallery herzustellen. In diesen Situationen können Sie das Az PowerShell-Modul offline mit einer dieser Methoden installieren.

Anmerkung

Die Optionen für die Offlineinstallation in diesem Artikel erfordern mindestens ein System mit Internetzugriff, um das Az PowerShell-Modul herunterzuladen, das sich von dem System unterscheiden kann, in dem Sie das Modul installieren möchten.

Voraussetzungen

Installieren Sie eine unterstützte Version von PowerShell Version 7 oder höher
Windows PowerShell 5.1 wird auch unterstützt, wenn Sie ein Windows-Betriebssystem verwenden.

Plattformübergreifend

Die folgenden Installationsoptionen für das Az PowerShell-Modul stehen plattformübergreifend auf allen Plattformen wie Windows, Linux und macOS zur Verfügung.

Aus Tar-Archiv installieren

Tipp

Das Befehlszeilenprogramm tar ist erforderlich, um diese Installationsoption zu verwenden. Es ist standardmäßig unter Windows 10, Version 1803 oder höher, den meisten Linux-Distributionen und aktuellen Versionen von macOS verfügbar.

Definieren Sie auf einem System mit Zugriff auf das Internet den Zielpfad, in dem Sie das Tar-Archiv speichern möchten.
```
$downloadFolderPath = "$home/Downloads"
```

Überprüfen Sie, ob der Downloadordner vorhanden ist. Falls nicht, erstellen Sie diesen.

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

Ermitteln Sie die URL des Tar-Archivs für die neueste Az PowerShell-Modulversion auf 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

Speichern Sie den Tar-Dateinamen und den Zieldateipfad in Variablen.

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

Laden Sie das Tar-Archiv von GitHub mit PowerShell herunter.

Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

Heben Sie die Blockierung der heruntergeladenen Datei auf, wenn Sie ein Windows-Betriebssystem ausführen.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
Anmerkung

Kopieren Sie das Tar-Archiv in Ihr Offlinesystem. Definieren Sie die $downloadFilePath und $downloadFolderPath Variablen, oder geben Sie tatsächliche Werte an, anstatt die Variablen in den folgenden Befehlen im Offlinesystem zu verwenden.

Extrahieren Sie den Inhalt des Tar-Archivs.

tar zxf $downloadFilePath -C $downloadFolderPath

Führen Sie das skript InstallModule.ps1 aus, das eine der extrahierten Dateien im Offlinesystem ist, in dem Sie das Az PowerShell-Modul installieren möchten.
```
.$downloadFolderPath/InstallModule.ps1
```

Speichern und Kopieren der Installation

Laden Sie das Az PowerShell-Modul mit Save-Module oder Save-PSResource über ein System mit Zugriff auf das Internet und den PowerShell-Katalog auf einen Netzwerkspeicherort herunter. Diese Befehle speichern das Az-Modul und seine Abhängigkeiten an dem angegebenen Speicherort. Verwenden Sie die gespeicherten Module als Installationsquelle, und kopieren Sie sie in das Offlinesystem.

Installieren über privates Repository

Erstellen Sie ein privates Repository in Ihrem lokalen Netzwerk, und verwenden Sie es als Installationsquelle für Ihr Offlinesystem. Weitere Informationen finden Sie unter Arbeiten mit privaten PowerShellGet-Repositorys.

Diese Methode ermöglicht die Zwischenspeicherung von PowerShell-Modulen auf einem einzelnen Server oder in einer einzelnen Dateifreigabe, um sie mithilfe von PowerShellGet oder Microsoft.PowerShell.PSResourceGet auf Systemen ohne Verbindung bereitzustellen.

Windows

Unter Windows haben Sie auch die Möglichkeit, das Az PowerShell-Modul mit einem MSI zu installieren, wenn Sie Windows PowerShell Version 5.1 verwenden.

Wichtig

Beachten Sie, dass das MSI-Installationsprogramm nur für Windows PowerShell 5.1 funktioniert.

Installieren von Azure PowerShell unter Windows per MSI-Installationsprogramm.

Fehlerbehebung

Lösungen für häufige Installationsprobleme mit dem Az PowerShell-Modul finden Sie unter Beheben von Installationsproblemen mit dem Az PowerShell-Modul.

Weitere Informationen

Nächste Schritte

Weitere Informationen zum Verwalten Ihrer Azure-Ressourcen mit dem Az PowerShell-Modul finden Sie unter Erste Schritte mit Azure PowerShell.

Freigeben über