Offlineinstallation von Azure PowerShell

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

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 sind plattformübergreifend auf allen Plattformen verfügbar, darunter Windows, Linux und macOS.

Aus Tar-Archiv installieren

1. Definieren Sie auf einem System mit Zugriff auf das Internet den Zielpfad, in dem Sie das Tar-Archiv speichern möchten.

   $downloadFolderPath = "$home/Downloads"
   

2. Überprüfen Sie, ob der Downloadordner vorhanden ist. Erstellen Sie andernfalls den Ordner.

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

3. 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
   

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

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

5. Laden Sie das Tar-Archiv aus GitHub mithilfe von PowerShell herunter.

   Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
   

6. 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 Werte und $downloadFolderPath Variablen, oder geben Sie tatsächliche Werte an, anstatt die Variablen in den folgenden Befehlen im Offlinesystem zu verwenden.

7. Extrahieren Sie den Inhalt des Tar-Archivs.

   tar zxf $downloadFilePath -C $downloadFolderPath
   

8. Führen Sie das InstallModule.ps1 Skript 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 mithilfe eines Systems mit Zugriff auf das Internet und der PowerShell-Katalog an 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 Freigabe zwischenspeichern, um sie mit PowerShellGet oder Microsoft.PowerShell.PSResourceGet auf beliebige getrennte Systeme bereitzustellen.

Windows

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

• Installieren Sie Azure PowerShell auf Windows mit dem MSI-Installer.

Problembehandlung

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

Siehe auch

• Save-Module
• Save-PSResource

Nächste Schritte

Weitere Informationen zum Verwalten Ihrer Azure-Ressourcen mit dem Az PowerShell-Modul finden Sie unter Get Started with Azure PowerShell.