Freigeben über

Migrieren von Azure PowerShell von AzureRM zu Az

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

Ermitteln, ob Sie das AzureRM PowerShell-Modul verwenden

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

Get-Module -Name AzureRM -ListAvailable

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

Upgrade auf das Az PowerShell-Modul

Skripts, die für die AzureRM-Cmdlets geschrieben wurden, funktionieren nicht automatisch mit Az. Um den Übergang zu vereinfachen, wurde das AzureRM zu Az Migration Toolkit entwickelt. Eine Migration zu einem neuen Befehlssatz ist nie bequem, aber dieser Artikel wird Ihnen beim Einstieg in das Az PowerShell-Modul helfen. Weitere Informationen dazu, warum das Az PowerShell-Modul erstellt wurde, finden Sie unter Einführung in das Az PowerShell-Modul.

Die neuen Cmdlet-Namen wurden so konzipiert, dass sie leicht zu erlernen sind. Verwenden Sie Azanstelle von AzureRm oder Azure in Cmdlet-Namen. Beispielsweise wurde das alte Cmdlet New-AzureRMVm zu New-AzVm. Die Migration umfasst jedoch mehr als nur das Vertrautmachen mit den neuen Cmdlet-Namen. Es gibt umbenannte Module, Parameter und andere wichtige Änderungen.

Die vollständige Liste der änderungen zwischen AzureRM und Az finden Sie in den vollständigen Änderungen von AzureRM zu Az.

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

Bevor Sie Migrationsschritte ausführen, bestimmen Sie, welche Versionen von AzureRM auf Ihrem System installiert sind. Auf diese Weise können Sie sicherstellen, dass Skripts bereits auf der neuesten Version ausgeführt werden, und Sie informieren, welche Versionen von AzureRM deinstalliert werden müssen.

Führen Sie das folgende Beispiel aus, um zu ermitteln, welche Versionen von AzureRM Sie installiert haben:

Get-Module -Name AzureRM -ListAvailable -All

Die neueste verfügbare Version von AzureRM ist 6.13.2. Wenn Sie diese Version nicht installiert haben, benötigen Ihre vorhandenen Skripts möglicherweise zusätzliche Änderungen, um mit dem Az-Modul zu arbeiten, das über den Umfang hinausgeht, der in diesem Artikel beschrieben wird, und in der liste der der letzten Änderungen.

Wenn Ihre Skripts nicht mit AzureRM 6.13.2 funktionieren, aktualisieren Sie sie gemäß dem AzureRM 5.x bis 6.x-Migrationshandbuch. Wenn Sie eine frühere Version des AzureRM-Moduls verwenden, stehen Migrationshandbücher für jede Hauptversion zur Verfügung.

Diese empfohlene Option minimiert den Aufwand, der zum Migrieren von AzureRM-Skripts nach Az erforderlich ist.

Mit dem AzureRM zu Az-Migrationstoolkit können Sie einen Plan generieren, um zu bestimmen, welche Änderungen an Ihren Skripts vorgenommen werden, bevor Sie Änderungen an diesen vornehmen und bevor Sie das Az PowerShell-Modul installieren.

Die PowerShell-Skripts automatisch von AzureRM in das Az PowerShell-Modul migrieren, Schnellstart führt Sie durch den gesamten Prozess der automatischen Aktualisierung Ihrer PowerShell-Skripts von AzureRM auf das Az PowerShell-Modul.

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

Das Az-Modul verfügt über einen Kompatibilitätsmodus, mit dem Sie vorhandene Skripts verwenden können, während Sie auf die neue Syntax aktualisieren. Das cmdlet Enable-AzureRmAlias ermöglicht einen Kompatibilitätsmodus über Aliase. Mit diesem Modus können Sie vorhandene Skripts mit minimaler Änderung verwenden, während Sie an einer vollständigen Migration zu Az arbeiten. Standardmäßig aktiviert Enable-AzureRmAlias nur Kompatibilitätsalias für die aktuelle PowerShell-Sitzung. Verwenden Sie den Parameter Scope, um Kompatibilitätsaliase über PowerShell-Sitzungen hinweg zu speichern. Weitere Informationen finden Sie in der Enable-AzureRmAlias Referenzdokumentation.

Wichtig

Obwohl die Cmdlet-Namen aliasiert sind, gibt es möglicherweise noch neue (oder umbenannte) Parameter oder geänderte Rückgabewerte für die Az-Cmdlets. Erwarten Sie nicht, dass das Ermöglichen von Aliases die Migration für Sie übernimmt. Sehen Sie sich die liste der vollständigen Änderungen an,, um zu finden, wo Ihre Skripts möglicherweise Updates erfordern.

Die Unterstützung für Enable-AzureRmAlias wird nicht veraltet, wenn das AzureRM PowerShell-Modul abgeschafft wird.

Nächste Schritte