Azure PowerShell: Versionsverwaltung, Veröffentlichungsintervall und Breaking Changes

  • Artikel

Beim Az PowerShell-Modul handelt es sich um ein Rollupmodul, das mehr als 70 allgemein verfügbare (GA) oder stabile Dienstmodule für die direkte Verwaltung von Azure-Ressourcen über PowerShell enthält.

Versionsverwaltung

Die Az PowerShell-Module halten sich bei der Versionsnummerierung an die semantische Versionierung. Versionen von Azure-Dienstmodulen lassen sich in drei Kategorien unterteilen:

  • Allgemein verfügbar. Module mit Version 1.0.0 und höher ohne Vorschauversion in der Version. Hält sich an die Breaking Change-Richtlinie.
  • Vorschau. Module mit einer niedrigeren Version als Version  1.0.0. Halten sich nicht an die Breaking Change-Richtlinie.
  • Funktionsvorschau. Module mit Version 1.0.0 und höher mit Vorschauversion in der Version. Halten sich nicht an die Breaking Change-Richtlinie.

Es gibt zwei Az PowerShell-Rollupmodule:

  • Az. Installiert alle GA-Dienstmodule zum Verwalten von Azure-Ressourcen.
  • AzPreview. Installiert alle GA- und Vorschaumodule zum Verwalten von Azure-Ressourcen. Enthält keine Module für die Funktionsvorschau.

Das AzPreview-Modul entspricht immer der Version des Az-Moduls und wird zur gleichen Zeit veröffentlicht.

Versionsrhythmus

Geplante Updates für das Az PowerShell-Modul werden am ersten Dienstag eines jeden Monats veröffentlicht. Diese zwölf geplanten Updates pro Kalenderjahr sind in zwei Kategorien unterteilt:

  • Hauptversionen. Maximal zwei pro Kalenderjahr enthalten Breaking Changes. Die erste Zahl in der Versionsnummer wird aktualisiert. Beispiel: Version 6.6.0 ändert sich in Version 7.0.0.
  • Nebenversionen. Zehn pro Kalenderjahr, die keine Breaking Changes enthalten. Die zweite Zahl in der Versionsnummer wird aktualisiert. Beispiel: Version 7.0.0 ändert sich in Version 7.1.0.

Warnung

Bevor Sie ein Upgrade auf eine Hauptversion des Az PowerShell-Moduls mit Breaking Changes durchführen, sollten Sie den Migrationsleitfaden lesen.

Ungeplante Patchversionen können jederzeit veröffentlicht werden, um Fehler zu beheben. Patchversionen enthalten keine Breaking Changes. Die dritte Zahl in der Versionsnummer wird aktualisiert. Beispiel: Version 6.2.0 ändert sich in Version 6.2.1.

Aktuelle Änderungen

Wichtig

Breaking Changes können zu jedem Zeitpunkt für nicht allgemein verfügbare Vorschaumodule und Funktionsvorschaumodule auftreten. Nicht allgemein verfügbare Module müssen sich nicht an die Breaking Change-Richtlinien halten.

Wann erfolgen Breaking Changes?

Wir veröffentlichen zwei Versionen von Breaking Changes pro Jahr:

  • Eine Ende des Frühjahrs
  • Eine im Herbst

Informationen zu bevorstehenden Releases von Breaking Changes finden Sie unter Azure PowerShell-Meilensteine.

Arten von Breaking Changes

In Cmdlets kann es verschiedene Arten von Breaking Changes geben. Weitere Informationen finden Sie unter Definition von Breaking Changes.

Liste der Breaking Changes

Ausführliche Informationen zu Breaking Changes in Hauptversionen des Az PowerShell-Moduls finden Sie in den folgenden Artikeln:

Warnmeldungen zu Breaking Changes

Warnmeldungen zu Breaking Changes ermöglichen es Ersteller*innen von Azure PowerShell-Cmdlets, Endbenutzer*innen über anstehende Breaking Changes zu informieren.

Unterdrücken von Warnmeldungen zu Breaking Changes

Informationen zum Unterdrücken von Warnmeldungen zu Breaking Changes finden Sie unter Wie deaktiviere ich Warnmeldungen zu Breaking Changes in Azure PowerShell?.

Weitere Informationen finden Sie unter Hilfe zu Attributen für Breaking Changes.

Feedback bereitstellen

Weitere Ressourcen