Installieren des Azure PowerShell-Dienstverwaltungsmoduls

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

Die Installation von Azure PowerShell aus dem PowerShell-Katalog ist die bevorzugte Installationsmethode.

Wichtig

Das Azure PowerShell-Dienstverwaltungsmodul funktioniert nur mit Windows PowerShell. Es kann nicht plattformübergreifend und nicht unter Linux oder macOS ausgeführt werden.

Schritt 1: Installieren von PowerShellGet

Für die Installation von Komponenten aus dem PowerShell-Katalog ist das PowerShellGet-Modul erforderlich. Stellen Sie sicher, dass Sie über die entsprechende Version von PowerShellGet verfügen und alle anderen Systemanforderungen erfüllt sind. Führen Sie den folgenden Befehl aus, um zu ermitteln, ob PowerShellGet auf Ihrem System installiert ist.

Get-InstalledModule -Name PowerShellGet -AllVersions |
  Select-Object -Property Name, Version, Path

Etwa folgende Ausgabe sollte angezeigt werden:

Name          Version Path
----          ------- ----
PowerShellGet 1.0.0.1 C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PowerShellGet.psd1

Falls PowerShellGet nicht installiert ist, lesen Sie Installieren von PowerShellGet.

Schritt 2: Installieren von Azure Powershell

Führen Sie über die Windows PowerShell-Konsole den folgenden Befehl als Administrator aus:

Install-Module -Name Azure

Das Azure-Modul ist ein Rollupmodul für die Azure-Dienstverwaltungs-Cmdlets. Bei der Installation des AzureRM-Moduls werden alle noch nicht installierten Azure-Module aus dem PowerShell-Katalog heruntergeladen und installiert.

Das Azure-Dienstverwaltungsmodul nutzt zum Teil die gleichen Abhängigkeiten wie die Azure PowerShell Resource Manager-Module. Wenn Sie die Azure PowerShell Resource Manager-Module installiert haben, müssen Sie dem Installationsbefehl den Parameter AllowClobber hinzufügen. So können die gemeinsam genutzten Abhängigkeiten aktualisiert werden. Ohne den Parameter ist die Installation des Moduls nicht erfolgreich.

Install-Module -Name Azure -AllowClobber

Nach der Installation können Sie das Modul mithilfe des folgenden Befehls importieren:

Import-Module -Name Azure

So verwenden Sie die Cmdlets

Melden Sie sich zunächst bei Ihrem Azure-Konto an, bevor Sie die Cmdlets der Azure-Dienstverwaltung verwenden. Führen Sie dazu den folgenden Befehl aus:

Add-AzureAccount

Nach der Anmeldung bei Azure erstellt Azure PowerShell einen Kontext für die Sitzung. Dieser Kontext enthält die Azure PowerShell-Umgebung, das Konto, den Mandanten und das Abonnement für alle Cmdlets innerhalb dieser Sitzung. Nun können Sie die folgenden Module verwenden.

Cmdlets der Azure-Dienstverwaltung

Sollten Sie feststellen, dass die Cmdlet-Onlinehilfe Cmdlets oder Parameter enthält, die in Ihrem Modul nicht vorhanden sind, laden Sie die neueste Version des Moduls herunter, und installieren Sie sie.

Beispielskripts zur Automatisierung einiger allgemeiner Aufgaben in Azure finden Sie im Azure Script Center.

Allgemeine Informationen zum Installieren, Kennenlernen, Verwenden und Anpassen von Windows PowerShell finden Sie unter Skripterstellung mit Windows PowerShell.

Installieren von PowerShellGet

Betriebssystemversion	Installationsanleitung
Ich besitze Windows 10, Windows Server 2016 oder höher.	In Windows Management Framework (WMF) 5.x integriert (im Betriebssystem enthalten)
Ich möchte auf PowerShell 5 aktualisieren.	Installieren Sie die aktuelle Version von WMF.

Überprüfen der Azure PowerShell-Version

Führen Sie zum Ermitteln der installierten Azure PowerShell-Version Get-InstalledModule -Name Azure in PowerShell aus.

Get-InstalledModule -Name Azure -AllVersions |
  Select-Object -Property Name,Version,Path