Offlineinstallation von Azure PowerShell

2025-07-15

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

Hinweis

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 einer unterstützten Version von PowerShell, Version 7 oder höher
Windows PowerShell 5.1 wird auch unterstützt, wenn Sie ein Windows-Betriebssystem ausführen.

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
}
```
Hinweis

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 aus einem privaten 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.

Mit dieser Methode können Sie PowerShell-Module auf einem einzelnen Server oder einer Dateifreigabe zwischenspeichern, die mit PowerShellGet oder Microsoft.PowerShell.PSResourceGet für alle nicht verbundenen Systeme bereitgestellt werden können.

Fenster

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.

Von Bedeutung

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

Installieren von Azure PowerShell unter Windows mit dem MSI Installer.

Problembehandlung

Lösungen zu häufigen Installationsproblemen mit dem Az-PowerShell-Modul finden Sie unter Behandeln von Installationsproblemen mit dem Az-PowerShell-Modul.

Siehe auch

Nächste Schritte

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