Freigeben über

Installieren von Azure PowerShell unter Windows

Das Az PowerShell-Modul ist ein Rollupmodul. Durch die Installation des Az PowerShell-Moduls werden die allgemein verfügbaren Module heruntergeladen und ihre Cmdlets zur Verwendung zur Verfügung gestellt.

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

  • Installieren aus der PowerShell-Galerie
  • 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 den folgenden Befehl aus PowerShell aus, um Ihre PowerShell-Version zu ermitteln:

    $PSVersionTable.PSVersion

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

    Get-Module -Name AzureRM -ListAvailable

    Von Bedeutung

    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.

Einrichtung

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

Durch das Aktualisieren des Az PowerShell-Moduls mit Update-Module werden keine alten Versionen des Az PowerShell-Moduls aus Ihrem System entfernt.

Deinstallation

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

In diesem Artikel wird erläutert, wie Sie das Az PowerShell-Modul unter Windows mithilfe eines MSI-Installationsprogramms installieren. Das MSI-Installationsprogramm wird für Umgebungen bereitgestellt, in denen der PowerShell-Katalog möglicherweise durch eine Firewall blockiert wird oder ein Offlineinstallationsprogramm erforderlich ist.

Von Bedeutung

Die MSI-Installationsoption kann nur verwendet werden, um das Az PowerShell-Modul für die Verwendung mit Windows PowerShell 5.1 zu installieren.

Voraussetzungen

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

    $PSVersionTable.PSVersion

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

    Get-Module -Name AzureRM -ListAvailable

    Von Bedeutung

    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][Execution-poliicies].

Installation und Aktualisierung

Das MSI-Paket für Azure PowerShell ist über [GitHub][azps-github] verfügbar.

  1. Besuchen Sie github.com/Azure/azure-powershell/releases
  2. Suchen Sie das neueste Az PowerShell-Modul. Sie werden chronologisch ohne Namen aufgeführt. Beispiel: 13.3.0
  3. Scrollen Sie nach unten bis zum Ende der Patchnotizen, und wählen Sie den Pfeil neben "Assets" aus, um die MSI-Optionen anzuzeigen.
  4. Wählen Sie die Az-Cmdlets MSI Ihrer Wahl aus, um den Download zu starten.

Das Installationsprogramm entfernt automatisch ältere Versionen des Az PowerShell-Moduls, die mit einem MSI installiert wurden. Das MSI-Paket installiert Module in "${env:ProgramFiles}\WindowsPowerShell\Modules"

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 Melden eines Problems mit dem Az PowerShell-Modul finden Sie unter: Ein Problem auf GitHub melden

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.