Freigeben über

Installieren des Azure PowerShell Service Management-Moduls

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Das Azure PowerShell Service Management-Modul ist ein Rollupmodul. Durch die Installation des Azure PowerShell Service Management-Moduls werden die allgemein verfügbaren Module für die Verwaltung älterer Azure-Ressourcen heruntergeladen, die Dienstverwaltungs-APIs verwenden und ihre Cmdlets zur Verwendung zur Verfügung stellen.

Voraussetzungen

Wichtig

Das Azure PowerShell Service Management-Modul funktioniert nur mit Windows PowerShell. Es ist nicht kompatibel mit PowerShell Version 6 oder höher und wird nicht unter Linux oder macOS ausgeführt.

  • Führen Sie den folgenden Befehl aus PowerShell aus, um Ihre PowerShell-Version zu ermitteln:

    $PSVersionTable.PSVersion

  • Aktualisieren auf Windows PowerShell 5.1

  • Legen Sie die PowerShell-Ausführungsrichtlinie auf „Remote signiert“ oder „Weniger restriktiv“ fest.

    • Überprüfen Sie die PowerShell-Ausführungsrichtlinie:

      Get-ExecutionPolicy -List

    • Legen Sie die PowerShell-Ausführungsrichtlinie auf „Remote signiert“ fest:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

      Weitere Informationen zu Ausführungsrichtlinien finden Sie unter about_Execution_Policies.

  • Aktualisieren von PowerShellGet für Windows PowerShell 5.1

Einrichtung

Verwenden Sie das Cmdlet Install-Module , um das Azure PowerShell Service Management-Modul zu installieren:

Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force

Das Azure PowerShell Service Management-Modul teilt Abhängigkeiten mit den Azure PowerShell Resource Manager-Modulen. Wenn Sie die Azure PowerShell Resource Manager-Module installiert haben, ist der Parameter AllowClobber erforderlich, wie im vorherigen Befehl gezeigt. So können die gemeinsam genutzten Abhängigkeiten aktualisiert werden. Ohne diesen Parameter schlägt die Installation des Moduls fehl.

Importieren Sie nach der Installation des Azure PowerShell Service Management-Moduls das Modul:

Import-Module -Name Azure

Anmelden

Um mit der Verwaltung Ihrer älteren Azure-Ressourcen mit dem Azure PowerShell Service Management-Modul zu beginnen, starten Sie eine PowerShell-Sitzung, und führen Sie Add-AzureAccount aus, um sich bei Azure anzumelden:

Add-AzureAccount

Nach der Anmeldung bei Azure erstellt das Azure PowerShell Service Management-Modul einen Kontext für die angegebene Sitzung. Dieser Kontext enthält die Azure-Umgebung, das Konto, den Mandanten und das Abonnement, die für alle Cmdlets innerhalb dieser Sitzung verwendet werden.

Problembehandlung

Wenn Sie die Fehlermeldung "Das angegebene Modul "Azure.Storage" mit Version "4.3.0" nicht geladen wurde, da keine gültige Moduldatei in einem Modulverzeichnis gefunden wurde.", müssen Sie das Azure.Storage PowerShell-Modul installieren:

Install-Module -Name Azure.Storage -Repository PSGallery -AllowClobber -Force

Wenn die Fehlermeldung „The 'Install-Module' command was found in the module 'PowerShellGet', but the module could not be loaded.“ angezeigt wird, müssen Sie die PowerShell-Ausführungsrichtlinie auf „Remote signiert“ oder „Weniger restriktiv“ festlegen.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Siehe auch

Weitere Informationen zu Befehlen im Azure PowerShell Service Management-Modul finden Sie in der Cmdlet-Referenzdokumentation.