Installieren von Azure PowerShell unter Windows

  • Artikel

Beim Az-PowerShell-Modul handelt es sich um ein Rollupmodul. Wenn Sie das Az-PowerShell-Modul installieren, werden die allgemein verfügbaren Module heruntergeladen und die zugehörigen Cmdlets verfügbar gemacht.

Die empfohlene Installationsmethode und PowerShell-Version für das Az-PowerShell-Modul:

  • Installieren aus dem PowerShell-Katalog
  • Zu verwenden mit PowerShell, Version 7 oder höher

In diesem Artikel erfahren Sie, wie Sie das Az-PowerShell-Modul unter Windows aus dem PowerShell-Katalog installieren.

Voraussetzungen

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

    $PSVersionTable.PSVersion

  • Ermitteln, ob Sie das AzureRM-PowerShell-Modul installiert haben:

    Get-Module -Name AzureRM -ListAvailable

    Wichtig

    Wenn Sie das PowerShell-Modul AzureRM installiert haben, lesen Sie Koexistenz von Az und AzureRM, ehe Sie fortfahren.

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

Installation

Verwenden Sie das Cmdlet Install-Module, um das Az-PowerShell-Modul zu installieren:

Install-Module -Name Az -Repository PSGallery -Force

Aktualisieren des Az-PowerShell-Moduls

Verwenden Sie Update-Module, um auf die neueste Version des Az-PowerShell-Moduls zu aktualisieren:

Update-Module -Name Az -Force

Wenn Sie das Az-PowerShell-Modul mithilfe von Update-Module aktualisieren, werden ältere Versionen des Az-PowerShell-Moduls nicht von Ihrem System entfernt.

Deinstallation

Informationen zum Entfernen des Az-PowerShell-Moduls finden Sie unter Deinstallieren des Azure PowerShell-Moduls.

In diesem Artikel erfahren Sie, wie Sie das Az-PowerShell-Modul unter Windows mit einem MSI-Installationsprogramm installieren. Das MSI-Installationsprogramm wird für Umgebungen bereitgestellt, in denen der PowerShell-Katalog unter Umständen durch eine Firewall blockiert oder in denen ein Offlineinstallationsprogramm benötigt wird.

Wichtig

Die MSI-Installationsoption kann nur zum Installieren des Az-PowerShell-Moduls für die Verwendung mit Windows PowerShell 5.1 verwendet werden.

Voraussetzungen

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

    $PSVersionTable.PSVersion

  • Ermitteln, ob Sie das AzureRM-PowerShell-Modul installiert haben

    Get-Module -Name AzureRM -ListAvailable

    Wichtig

    Wenn Sie das PowerShell-Modul AzureRM installiert haben, lesen Sie Koexistenz von Az und AzureRM, ehe Sie fortfahren.

  • Aktualisieren auf Windows PowerShell 5.1

  • Installieren von .NET Framework 4.7.2 oder höher

  • Legen Sie die PowerShell-Skriptausführung 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.

Installation und Aktualisierung

Das MSI-Paket für Azure PowerShell ist auf GitHub verfügbar:

  1. Besuchen Sie github.com/Azure/azure-powershell/releases.
  2. Suchen Sie das neueste Az-PowerShell-Modul. Sie sind chronologisch ohne Namen aufgeführt. Beispiel: 9.5.0
  3. Scrollen Sie nach unten bis zum Ende der Patchhinweise, und klicken Sie auf den Pfeil neben „Ressourcen“, um die MSI-Optionen anzuzeigen.
  4. Klicken Sie auf die MSI-Datei Ihrer Wahl für die Az-Cmdlets, um den Download zu starten.

Das Installationsprogramm entfernt automatisch ältere Versionen des Az-PowerShell-Moduls, die mithilfe einer MSI-Datei installiert wurden. Mit dem MSI-Paket werden Module unter "${env:ProgramFiles}\WindowsPowerShell\Modules" installiert.

Anmelden

Um mit der Verwaltung Ihrer Azure-Ressourcen mit dem Az-PowerShell-Modul zu beginnen, starten Sie eine PowerShell-Sitzung, und führen Sie Connect-AzAccount aus, um sich bei Azure anzumelden:

Connect-AzAccount

Verwenden Sie die Anmeldeinformationen Ihres Azure-Kontos, um sich bei dem Browserfenster anzumelden, das geöffnet wird.

Sie müssen diesen Schritt für jede neue PowerShell-Sitzung wiederholen, die Sie starten. Informationen zum PowerShell-sitzungsübergreifenden Speichern Ihrer Azure-Anmeldung finden Sie unter Azure PowerShell-Kontextobjekte.

Problembehandlung

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

Feedback geben

Informationen zum Einreichen eines Problems mit dem Az-PowerShell-Modul finden Sie unter Melden eines Problems auf GitHub.

Wenn Sie Feedback innerhalb einer PowerShell-Sitzung bereitstellen möchten, können Sie das Cmdlet Send-Feedback verwenden.

Nächste Schritte

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