Freigeben über


Einführung in das Az PowerShell-Modul

Überblick

Das Az PowerShell-Modul ist eine Reihe von Cmdlets zum direkten Verwalten von Azure-Ressourcen über PowerShell. PowerShell bietet leistungsstarke Features für die Automatisierung, die zum Verwalten Ihrer Azure-Ressourcen genutzt werden können, z. B. im Kontext einer CI/CD-Pipeline.

Das Az PowerShell-Modul ist der Ersatz für AzureRM und 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 fortgesetzte Unterstützung und Updates sicherzustellen.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr verwaltet oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Sie können das Az PowerShell-Modul mit einer der folgenden Methoden verwenden:

Features

Das Az PowerShell-Modul bietet die folgenden Vorteile:

  • Sicherheit und Stabilität
    • Token-Cache-Verschlüsselung
    • Verhindern von Man-in-the-Middle-Angriffen
    • Unterstützung der Authentifizierung mit ADFS 2019
    • Benutzernamen- und Kennwortauthentifizierung in PowerShell 7
    • Unterstützung für Funktionen wie kontinuierliche Bewertung des Zugriffs
  • 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
    • Kann Zugriffstoken für den Zugriff auf Azure-Ressourcen abrufen und verwenden
    • Cmdlet für erweiterte REST-Vorgänge mit Azure-Ressourcen verfügbar

Anmerkung

PowerShell 7.2 oder höher ist die empfohlene Version von PowerShell für die Verwendung mit dem Az PowerShell-Modul auf allen Plattformen.

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

Wir verpflichten uns, Azure-Support auf alle Plattformen zu bringen, und alle Az PowerShell-Module sind plattformübergreifend.

Aktualisieren Sie Ihre Umgebung zu Az

Um mit den neuesten Azure-Features in PowerShell schritt zu halten, 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 zum Experimentieren mit Az zur Verfügung:

  • 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.
  • Behalten Sie das AzureRM-Modul in Windows PowerShell 5.1 bei, und installieren Sie das Az-Modul in PowerShell 7 oder höher. Windows PowerShell 5.1 und PowerShell 7 und höher verwenden separate Auflistungen von Modulen. Folgen Sie den Anweisungen, um die neueste Version von PowerShell zu installieren, und installieren Sie dann das Az-Modul von PowerShell 7 oder höher.

So führen Sie ein Upgrade von einer vorhandenen AzureRM-Installation aus:

  1. Deinstallieren des Azure PowerShell AzureRM-Moduls
  2. Installieren des Az PowerShell-Moduls
  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 weiterhin auf dem AzureRM-Modul basieren, haben wir mehrere Ressourcen, die Ihnen bei der Migration helfen:

Haltbarkeit

Az ist das aktuelle 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. Um Ihre Skripts automatisch zu aktualisieren, folgen Sie der Schnellstartanleitung.

Datensammlung

Azure PowerShell sammelt Telemetriedaten standardmäßig. Microsoft aggregiert gesammelte Daten, um Nutzungsmuster zu identifizieren, um häufige Probleme zu identifizieren und die Erfahrung von Azure PowerShell zu verbessern. Microsoft Azure PowerShell sammelt keine privaten oder persönlichen Daten. Die Nutzungsdaten tragen beispielsweise dazu bei, Probleme zu identifizieren (z. B. Cmdlets mit mäßigem Erfolg) und unsere Arbeit zu priorisieren.

Obwohl wir die Erkenntnisse schätzen, die diese Daten liefern, wissen wir 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.