Freigeben über


Installieren von Azure PowerShell auf Windows

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

In diesem Artikel wird erläutert, wie Sie das Az PowerShell-Modul auf 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 AzureRM PowerShell-Modul installiert haben, lesen Sie die Koexistenz von Az und AzureRM , bevor Sie fortfahren.

  • Festlegen der PowerShell-Ausführungsrichtlinie auf Remotesignatur oder weniger restriktiv

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

Das Aktualisieren des Az PowerShell-Moduls mit Update-Module entfernt keine alten Versionen des Az PowerShell-Moduls von Ihrem System.

Deinstallation

Informationen zum Entfernen des Az PowerShell-Moduls finden Sie unter Uninstallieren sie das Azure PowerShell Modul.

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

Von Bedeutung

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

    Von Bedeutung

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

  • Aktualisieren auf Windows PowerShell 5.1

  • Installieren sie .NET Framework 4.7.2 oder höher

  • Festlegen der PowerShell-Skriptausführung auf Remotesignatur oder weniger restriktiv

    • Ü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 Update

Das MSI-Paket für Azure PowerShell steht unter [GitHub][azps-github]:

  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

Melden Sie sich mit Ihren Azure Kontoanmeldeinformationen beim daraufhin geöffneten Browserfenster an.

Sie müssen diesen Schritt für jede neue PowerShell-Sitzung wiederholen, die Sie starten. Informationen dazu, wie Sie Ihre Azure-Anmeldeinformationen über PowerShell-Sitzungen hinweg beibehalten, finden Sie unter Azure PowerShell Kontextobjekte.

Problembehandlung

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, siehe: Problem auf GitHub einreichen

Verwenden Sie das Send-Feedback-Cmdlet , um Feedback innerhalb einer PowerShell-Sitzung bereitzustellen.

Nächste Schritte

Weitere Informationen zum Verwalten Ihrer Azure-Ressourcen mit dem Az PowerShell-Modul finden Sie unter Get Started with Azure PowerShell.