Freigeben über

Installieren von Azure PowerShell unter Windows

  • Artikel

Beim Az-PowerShell-Modul handelt es sich um 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 dem PowerShell-Katalog
  • 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

    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-Modul, 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 steht für Umgebungen zur Verfügung, in denen die PowerShell-Galerie möglicherweise durch eine Firewall blockiert wird, oder wenn ein Offline-Installationsprogramm erforderlich ist.

Wichtig

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 das AzureRM PowerShell-Modul installiert ist

    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 Update

Das MSI-Paket für Azure PowerShell ist über GitHubverfü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: 9.5.0
  3. Scrollen Sie nach unten bis zum Ende der Patchnotizen, und klicken Sie auf den Pfeil neben "Objekte", 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 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

Melden Sie sich mit Ihren Anmeldeinformationen für Ihr Azure-Konto beim geöffneten Browserfenster an.

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.

Fehlerbehebung

Lösungen für häufige Installationsprobleme mit dem Az PowerShell-Modul finden Sie unter Beheben 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.