Migrieren von Azure PowerShell von AzureRM zu Az

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 ausführen, um festzustellen, ob eines der 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 einfach, aber dieser Artikel hilft Ihnen beim Einstieg in den Übergang zum Az PowerShell-Modul. 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. Anstatt AzureRm oder Azure in Cmdletnamen zu verwenden, verwenden Sie Az. Das alte Cmdlet ist beispielsweise geworden . Die Migration besteht jedoch aus mehr, als sich nur mit den neuen Cmdlet-Namen vertraut zu machen. Es gibt umbenannte Module, Parameter und andere wichtige Änderungen.

Um die vollständige Liste der Änderungen zwischen AzureRM und Az zu sehen, konsultieren Sie die detaillierten Verä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 über den Rahmen dessen hinaus zu arbeiten, was in diesem Artikel und in der Liste der einschneidenden Änderungen beschrieben ist.

Wenn Ihre Skripts nicht mit AzureRM 6.13.2 funktionieren, aktualisieren Sie sie gemäß dem AzureRM 5.x-Migrationshandbuch auf 6.x. 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.

Die Quickstart-Anleitung zur automatischen Migration von PowerShell-Skripts von AzureRM auf das Az PowerShell-Modul erklärt Ihnen den gesamten Vorgang, Ihre PowerShell-Skripts automatisch von AzureRM auf das Az PowerShell-Modul zu aktualisieren.

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 werden nur Kompatibilitätsalias für die aktuelle PowerShell-Sitzung aktiviert. Verwenden Sie dessen Parameter, um Kompatibilitätsaliase über PowerShell-Sitzungen hinweg beizubehalten. Weitere Informationen finden Sie in der Enable-AzureRmAlias Referenzdokumentation.

Die Unterstützung wird nicht eingestellt, wenn das AzureRM PowerShell-Modul veraltet ist.

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
• Deinstallieren von AzureRM