Migrieren von Azure PowerShell von AzureRM zu Azure

  • 7 Minuten

Skripts, die für die AzureRM-Cmdlets erstellt wurden, 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 niemals bequem, aber Sie müssen unbedingt wissen, wie der Übergang zum Az-PowerShell-Modul erfolgt.

Die neuen Cmdlet-Namen sind einfacher zu lernen. Anstelle von AzureRm oder Azure in Cmdlet-Namen verwenden Sie Az-Cmdlets. Beispielsweise wurde das alte Cmdlet New-AzureRMVm zu New-AzVm. Die Migration umfasst jedoch mehr, als sich nur mit den neuen Cmdlet-Namen vertraut zu machen. Es gibt umbenannte Module, Parameter und andere wichtige Änderungen.

Überprüfen Sie, welche Versionen von AzureRM auf Ihrem System installiert sind, 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 den folgenden Befehl aus, um die installierten Versionen von AzureRM zu ermitteln:

Get-Module -Name AzureRM -ListAvailable -All

Hinweis

Die aktuellste verfügbare Version von AzureRM ist 6.13.1. Wenn diese Version nicht installiert ist, sind für Ihre vorhandenen Skripts möglicherweise weitere Änderungen erforderlich, damit das Az-Modul verwendet werden kann.

Die empfohlene Option zum Migrieren von AzureRM zum Az PowerShell-Modul ist die automatische Migration. Dazu müssen Sie das Toolkit für die Migration von AzureRM zu Az installieren, indem Sie den folgenden Befehl ausführen:

Install-Module -Name Az.Tools.Migration

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.

Weitere Dokumentation: Informationen zu den Schritten für die automatische Migration finden Sie in Schnellstart: Automatisches Migrieren von PowerShell-Skripts von AzureRM zum Az PowerShell-Modul.

Sie können auch Microsoft Visual Studio Code verwenden, um Ihre vorhandenen Skripts zu migrieren. Dazu müssen Sie zuerst die Azure PowerShell-Erweiterung für Visual Studio Code installieren. Anschließend müssen Sie die folgenden Schritte ausführen:

  1. Laden Sie Ihr AzureRM-Skript in Visual Studio Code.
  2. Drücken Sie Strg+Umschalt+P, um die Befehlspalette zu öffnen.
  3. Wählen Sie das Skript Migrate Azure PowerShell aus.
  4. Wählen Sie die AzureRM-Quellversion aus.
  5. Führen Sie die empfohlenen Aktionen für jeden unterstrichenen Befehl oder Parameter aus.