Migrieren von Azure PowerShell von AzureRM zum Az-Modul

  • Artikel

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.

Ermitteln, ob Sie das AzureRM-PowerShell-Modul verwenden

Verwenden Sie den folgenden Befehl, um zu ermitteln, ob Sie das AzureRM-PowerShell-Modul installiert haben:

Get-Module -Name AzureRM -ListAvailable

Sie können auch eine Volltextsuche Ihrer Skripts für das Muster *-AzureRM* durchführen, um festzustellen, ob eines der Skripts das AzureRM PowerShell-Modul verwendet.

Upgrade des Az-PowerShell-Moduls

Für die AzureRM-Cmdlets geschriebene Skripts funktionieren nicht automatisch mit dem Az-Modul. Um den Umstieg zu vereinfachen, wurde das Toolkit für die Migration von AzureRM zu Az entwickelt. Eine Migration zu einem neuen Befehlssatz ist immer unangenehm. Dieser Artikel hilft Ihnen jedoch dabei, den Umstieg auf das Az PowerShell-Modul in die Wege zu leiten. Weitere Informationen zu den Gründen für die Entwicklung des Az PowerShell-Moduls finden Sie unter Einführung in das Az PowerShell-Modul.

Die neuen Cmdlet-Namen sind ganz einfach zu lernen. Verwenden Sie in Cmdlet-Namen nicht mehr AzureRm oder Azure, sondern Az. Das alte Cmdlet New-AzureRMVm heißt jetzt beispielsweise New-AzVm. Die Migration umfasst jedoch mehr als das Erlernen der neuen Cmdlet-Namen. Es gibt umbenannte Module, Parameter und andere wichtige Änderungen.

Die vollständige Liste mit grundlegenden Änderungen zwischen AzureRM und Az finden Sie unter Vollständige Änderungen von AzureRM zu Az.

Vergewissern, dass vorhandene Skripts mit der neuesten AzureRM-Version funktionieren

Ermitteln Sie die auf Ihrem System installierten Versionen von AzureRM, bevor Sie Migrationsschritte ausführen. So können Sie sicherstellen, dass für Skripts bereits das aktuelle Release verwendet wird, und ermitteln, welche Versionen von AzureRM deinstalliert werden müssen.

Führen Sie das folgende Beispiel aus, um festzustellen, welche Versionen von AzureRM bei Ihnen installiert sind:

Get-Module -Name AzureRM -ListAvailable -All

Die aktuellste verfügbare Version von AzureRM ist 6.13.2. Sollte diese Version nicht installiert sein, sind zur Verwendung des Az-Moduls möglicherweise zusätzliche Änderungen für Ihre vorhandenen Skripts erforderlich, die nicht in diesem Artikel und der Breaking Changes-Liste beschrieben werden.

Wenn Ihre Skripts nicht mit AzureRM 6.13.2 funktionieren, aktualisieren Sie sie gemäß dem Leitfaden zur Migration von AzureRM 5.x zu 6.x. Wenn Sie eine frühere Version des AzureRM-Moduls verwenden, gibt es für jede Hauptversion Migrationsleitfäden.

Die empfohlene Option minimiert den erforderlichen Aufwand für die Migration von AzureRM-Skripts zu Az.

Mit dem Toolkit für die Migration von AzureRM zu Az können Sie einen Plan generieren, um zu ermitteln, welche Änderungen für Ihre Skripts vorgenommen werden, bevor Sie tatsächlich Änderungen vornehmen und das Az PowerShell-Modul installieren.

In der Schnellstartanleitung Automatisches Migrieren von PowerShell-Skripts von AzureRM zum Az PowerShell-Modul werden die einzelnen Schritte für die automatische Aktualisierung Ihrer PowerShell-Skripts von AzureRM auf das Az PowerShell-Modul beschrieben.

Option 2: Verwenden des Kompatibilitätsmodus mit „Enable-AzureRmAlias“

Das Az-Modul verfügt über einen Kompatibilitätsmodus, der Ihnen die Verwendung bereits vorhandener Skripts ermöglicht, während Sie das Update auf die neue Syntax durchführen. Mit dem Cmdlet Enable-AzureRmAlias können Sie über Aliase einen Kompatibilitätsmodus nutzen. Dieser Modus ermöglicht es Ihnen, vorhandene Skripts mit minimalen Änderungen zu verwenden, während Sie an der vollständigen Migration zu Az arbeiten. Standardmäßig aktiviert Enable-AzureRmAlias nur Kompatibilitätsaliase für die aktuelle PowerShell-Sitzung. Verwenden Sie den Parameter Scope, um Kompatibilitätsaliase über PowerShell-Sitzungen hinweg beizubehalten. Weitere Informationen finden Sie in der Referenzdokumentation zu Enable-AzureRmAlias.

Wichtig

Auch wenn die Cmdlet-Namen mit Aliasen versehen sind, kann es dennoch neue (oder umbenannte) Parameter oder geänderte Rückgabewerte für die Az-Cmdlets geben. Erwarten Sie nicht, dass die Migration durch die Aktivierung von Aliasen erfolgt. Weitere Informationen zu möglicherweise erforderlichen Änderungen an Ihren Skripts finden Sie in der Vollständigen Liste der Breaking Changes.

Die Unterstützung für Enable-AzureRmAlias wird bei Einstellung der Unterstützung für das AzureRM PowerShell-Modul nicht eingestellt.

Nächste Schritte