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 *-AzureRM* 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. Es ist keine Migration zu einem neuen Befehlssatz praktisch, aber dieser Artikel hilft Ihnen bei den ersten Schritten beim Ü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. Verwenden Sie Azanstelle von Cmdlet-Namen AzureRm oder Azure in Cmdlet-Namen . Das alte Cmdlet New-AzureRMVm ist beispielsweise geworden New-AzVm. Die Migration ist jedoch mehr als mit den neuen Cmdlet-Namen vertraut zu werden. 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 außerhalb des Umfangs der in diesem Artikel und in der Liste der änderungen unterbrechenden Änderungen zu arbeiten.

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 Automatische Migration von PowerShell-Skripts von AzureRM in das Az PowerShell-Modul 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. Enable-AzureRmAlias Standardmäßig werden nur Kompatibilitätsalias für die aktuelle PowerShell-Sitzung aktiviert. Verwenden Sie den Scope Parameter, um Kompatibilitätsalias in PowerShell-Sitzungen beizubehalten. Weitere Informationen finden Sie in der Enable-AzureRmAlias Referenzdokumentation.

Die Unterstützung für Enable-AzureRmAlias diese Wird nicht mehr unterstützt, 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