Freigeben über


Installieren des Azure PowerShell-Dienstverwaltungsmoduls

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.

Beim Azure PowerShell-Dienstverwaltungsmodul handelt es sich um ein Rollupmodul. Durch die Installation des Azure PowerShell-Dienstverwaltungsmoduls werden die allgemein verfügbaren Module für die Verwaltung von Azure-Legacyressourcen heruntergeladen, die Dienstverwaltungs-APIs verwenden, und ihre Cmdlets zur Verwendung zur Verfügung gestellt.

Voraussetzungen

Wichtig

Das Azure PowerShell-Dienstverwaltungsmodul funktioniert nur mit Windows PowerShell. Es ist nicht kompatibel mit PowerShell Version 6 oder höher und kann nicht unter Linux oder macOS ausgeführt werden.

  • Führen Sie zum Ermitteln Ihrer PowerShell-Version den folgenden Befehl in PowerShell aus:

    $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

Installation

Verwenden Sie das Cmdlet Install-Module, um das Azure PowerShell-Dienstverwaltungsmoduls zu installieren:

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

Das Azure PowerShell-Dienstverwaltungsmodul nutzt zum Teil die gleichen Abhängigkeiten wie die Resource Manager-Module von Azure PowerShell. 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 den Parameter ist die Installation des Moduls nicht erfolgreich.

Nachdem Sie Azure PowerShell-Dienstverwaltungsmodul installiert haben, importieren Sie das Modul:

Import-Module -Name Azure

Anmelden

Um mit der Verwaltung Ihrer Azure-Legacyressourcen mit dem Azure PowerShell-Dienstverwaltungsmodul 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-Dienstverwaltungsmodul einen Kontext für die Sitzung. Dieser Kontext enthält die Azure-Umgebung, das Konto, den Mandanten und das Abonnement für alle Cmdlets innerhalb dieser Sitzung.

Problembehandlung

Wenn die Fehlermeldung „The specified module 'Azure.Storage' with version '4.3.0' was not loaded because no valid module file was found in any module directory.“ angezeigt wird, müssen Sie das PowerShell-Modul „Azure.Storage“ 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-Dienstverwaltungsmodul finden Sie in der Referenzdokumentation zu Cmdlets.