Einführung in das Az PowerShell-Modul

  • Artikel

Übersicht

Beim Az PowerShell-Modul handelt es sich um einen Satz von Cmdlets zum direkten Verwalten von Azure-Ressourcen über PowerShell. PowerShell bietet leistungsstarke Features für die Automatisierung, die Sie zum Verwalten Ihrer Azure-Ressourcen nutzen können, beispielsweise im Rahmen einer CI/CD-Pipeline.

Das Az PowerShell-Modul ersetzt AzureRM und ist das empfohlene Modul für die Interaktion mit Azure.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Zur Verwendung des Az PowerShell-Moduls stehen Ihnen die folgenden Methoden zur Auswahl:

Features

Das Az PowerShell-Modul bietet die folgenden Vorteile:

  • Sicherheit und Stabilität
    • Verschlüsselung des Tokencaches
    • Verhindern von Man-in-the-Middle-Angriffen
    • Unterstützen der Authentifizierung mit ADFS 2019
    • Benutzernamen- und Kennwortauthentifizierung in PowerShell 7
    • Unterstützung für Features wie die fortlaufende Zugriffsevaluierung
  • Unterstützung für alle Azure-Dienste
    • Alle allgemein verfügbaren Azure-Dienste verfügen über ein entsprechendes unterstütztes PowerShell-Modul.
    • Mehrere Fehlerbehebungen und API-Versionsupgrades seit AzureRM
  • Neue Funktionen
    • Unterstützung in Cloud Shell und plattformübergreifend
    • Abrufen und Verwenden von Zugriffstoken für den Zugriff auf Azure-Ressourcen
    • Cmdlet für erweiterte REST-Vorgänge mit Azure-Ressourcen verfügbar

Hinweis

Zur Verwendung mit dem Az PowerShell-Modul auf allen Plattformen wird die PowerShell-Version 7.2 oder höher empfohlen.

Das neue Az PowerShell-Modul basiert auf der .NET Standard-Bibliothek und funktioniert mit PowerShell 7.2 und höher auf allen Plattformen, einschließlich Windows, Linux und macOS. Es ist auch mit Windows PowerShell 5.1 kompatibel.

Unser Ziel ist es, Azure auf allen Plattformen zu unterstützen, und alle Az PowerShell-Module sind plattformübergreifend.

Aktualisieren Ihrer Umgebung auf Az

Damit Sie hinsichtlich der neuesten Azure-Features in PowerShell auf dem Laufenden bleiben, sollten Sie zum Az-Modul migrieren. Wenn Sie nicht bereit sind, das Az-Modul als Ersatz für AzureRM zu installieren, stehen Ihnen einige Optionen zur Verfügung, um mit Az zu experimentieren:

  • Verwenden Sie eine PowerShell-Umgebung mit Azure Cloud Shell. Azure Cloud Shell ist eine browserbasierte Shellumgebung, die mit installiertem Az-Modul und aktivierten Enable-AzureRM-Kompatibilitätsaliasen bereitgestellt wird.
  • Lassen Sie das AzureRM-Modul in Windows PowerShell 5.1 installiert, und installieren Sie das Az-Modul in PowerShell 7 oder höher. Windows PowerShell 5.1 sowie PowerShell 7 und höher verwenden separate Modulsammlungen. Befolgen Sie die Anweisungen zum Installieren der aktuellen PowerShell-Version, und installieren Sie das Az-Modul dann über PowerShell 7 oder höher.

So führen Sie ein Upgrade von einer bestehenden AzureRM-Installation durch

  1. Deinstallieren Sie das AzureRM-Modul von Azure PowerShell.
  2. Installieren Sie das Az-Modul von PowerShell.
  3. OPTIONAL: Aktivieren Sie den Kompatibilitätsmodus, um Aliase für AzureRM-Cmdlets mit Enable-AzureRMAlias hinzuzufügen, während Sie sich mit den neuen Befehlen vertraut machen. Weitere Informationen finden Sie im nächsten Abschnitt oder unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

Migrieren vorhandener Skripts von AzureRM zu Az

Wenn Ihre Skripts noch auf dem AzureRM-Modul basieren, stehen Ihnen verschiedene Ressourcen zur Verfügung, die Sie bei der Migration unterstützen:

Support-Fähigkeit

Az ist das aktuellste PowerShell-Modul für Azure. Wenn Sie Probleme melden oder Featureanfragen senden möchten, können Sie diese direkt im GitHub-Repository eingeben, oder sich an den Microsoft-Support wenden, falls Sie über einen Supportvertrag verfügen. Featureanfragen werden in der aktuellen Version von Az implementiert. Behebungen kritischer Probleme werden in den letzten beiden Versionen von Az implementiert.

Die Az PowerShell-Module bieten nun die gleichen Funktionen wie AzureRM PowerShell-Module und weitere Funktionen, daher wurden die AzureRM PowerShell-Module am 29. Februar 2024 eingestellt.

Um Dienstunterbrechungen zu vermeiden, aktualisieren Sie Ihre Skripts, die AzureRM PowerShell-Module verwenden, auf die Verwendung von Az PowerShell-Modulen. Befolgen Sie zum automatischen Aktualisieren Ihrer Skripts die Schnellstartanleitung.

Datensammlung

Azure PowerShell sammelt standardmäßig Telemetriedaten. Microsoft aggregiert gesammelte Daten, um Verwendungsmuster zu identifizieren, allgemeine Probleme zu ermitteln und die Benutzerfreundlichkeit von Azure PowerShell zu verbessern. Microsoft Azure PowerShell sammelt keine privaten oder personenbezogenen Daten. Die Nutzungsdaten tragen beispielsweise dazu bei, Probleme zu identifizieren (z. B. Cmdlets mit mäßigem Erfolg) und unsere Arbeit zu priorisieren.

Wir schätzen die Erkenntnisse, die uns diese Daten liefern, wissen aber auch, dass nicht jeder Nutzungsdaten senden möchte. Sie können die Datensammlung mit dem Cmdlet Disable-AzDataCollection deaktivieren. Weitere Informationen finden Sie bei Bedarf auch in unseren Datenschutzbestimmungen.