Freigeben über

Installieren von Azure PowerShell unter Windows

  • Artikel

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
  • Verwenden mit PowerShell, Version 7 oder höher

In diesem Artikel wird erläutert, wie Sie das Az PowerShell-Modul unter Windows aus dem PowerShell-Kataloginstallieren.

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 AzureRM PowerShell-Modul installiert haben, lesen Sie Az und AzureRM-Koexistenz, bevor Sie fortfahren.

  • Legen Sie die PowerShell-Ausführungsrichtlinie auf 'RemoteSigned' oder weniger restriktiv fest.

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

      Get-ExecutionPolicy -List

    • Legen Sie die PowerShell-Ausführungsrichtlinie auf "Remotesignatur" 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 Updatemodul-, 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.

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 AzureRM PowerShell-Modul installiert haben, lesen Sie Az und AzureRM-Koexistenz, bevor Sie fortfahren.

  • Aktualisieren auf Windows PowerShell 5.1

  • Installieren .NET Framework 4.7.2 oder höher

  • Legen Sie die PowerShell-Skriptausführung auf „RemoteSigniert“ oder weniger restriktiv fest.

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

      Get-ExecutionPolicy -List

    • Legen Sie die PowerShell-Ausführungsrichtlinie auf "Remotesignatur" 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 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: 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 Az-Cmdlets MSI Ihrer Wahl, 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 Speichern Ihrer Azure-Anmeldung in PowerShell-Sitzungen 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

Um ein Problem mit dem Az PowerShell-Modul zu melden, sehen Sie: ein Problem auf GitHub melden

Um Feedback innerhalb einer PowerShell-Sitzung bereitzustellen, verwenden Sie das Cmdlet Senden-Feedback-.

Nächste Schritte

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