Azure PowerShell von AzureRM auf Az migrieren

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 Umstieg zu vereinfachen, wurde das Toolkit für die Migration von AzureRM zu Az entwickelt. Eine Migration zu einem neuen Befehlssatz ist nie einfach, aber dieser Artikel wird Ihnen helfen, den Wechsel zum Az PowerShell-Modul zu starten. 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 bedeutet jedoch mehr, als nur mit den neuen Cmdlet-Namen vertraut zu werden. 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.

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 es informiert Sie darüber, 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 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 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.

Option 1 (empfohlen): Automatische Migration Ihrer PowerShell-Skripts

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.

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, mit dem Sie vorhandene Skripts verwenden können, während Sie auf die neue Syntax aktualisieren. Mit dem Cmdlet Enable-AzureRmAlias können Sie über Aliase einen Kompatibilitätsmodus nutzen. 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ä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.

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

Nächste Schritte

• Automatisches Migrieren von PowerShell-Skripts
• Einführung in das Az PowerShell-Modul
• Änderungen zwischen AzureRM und Az
• Installieren des Az PowerShell-Moduls
• AzureRM- deinstallieren