Übersicht über das PowerShell-Modul Az.Tools.Migration

  • Artikel

Das PowerShell-Modul Az.Tools.Migration unterstützt den Übergang vom älteren AzureRM-Modul zum neueren Az-Modul, das für die Azure-Verwaltung empfohlen wird.

Wichtig

Das PowerShell-Modul von AzureRM ist seit dem 29. Februar 2024 veraltet.

Microsoft hat das Modul Az.Tools.Migration als Reaktion auf Kundenfeedback eingeführt. Dieses Feedback bezog sich vorwiegend auf den Aufwand, der für das Aktualisieren von Skripts benötigt wird, die ursprünglich für das AzureRM-Modul geschrieben wurden. Die Erkenntnis, dass viele Kunden in die Erstellung komplexer Skripts für Azure-Umgebungen investiert haben, hat zur Erstellung des Moduls Az.Tools.Migration geführt. Mit diesem Modul kann der Migrationsprozess optimiert und automatisiert werden, wodurch die manuelle Arbeitsauslastung und das Fehlerpotenzial bei Skriptupgrades reduziert werden.

Verwenden des Az.Tools.Migration-Moduls

Der Verwendungsprozess des Moduls Az.Tools.Migration umfasst mehrere Schritte:

  1. Aktualisieren auf die Version 6.13.1 von AzureRM: Bevor sie das Az.Tools.Migration-Modul verwenden, müssen Benutzer*innen sicherstellen, dass ihre Skripts auf Version 6.13.1 von AzureRM aktualisiert werden. Dabei handelt es sich um die letzte Version vor der Migration zum Az-Modul.

  2. Installieren von Az.Tools.Migration: Das Modul kann mit dem Befehl Install-Module -Name Az.Tools.Migration aus dem PowerShell-Katalog installiert werden.

  3. Generieren eines Upgradeplans: Das Cmdlet New-AzUpgradeModulePlan generiert einen Upgradeplan. Es werden keine vorhandenen Skripts geändert. Stattdessen wird ein Upgradepfad bereitgestellt, indem ein Plan erstellt wird, der bestimmte Dateien und Offsetpunkte enthält, die aktualisiert werden müssen. Dieses Cmdlet verwendet Parameter wie FilePath und DirectoryPath für bestimmte Skripts oder Ordner.

  4. Überprüfung des Upgradeplans: Vor dem Ausführen des Upgrades ist es wichtig, den Plan auf potenzielle Probleme zu überprüfen, die möglicherweise automatische Upgrades verhindern. Dazu gehören unter anderem Befehle, die Splatting verwenden und bei Bedarf manuell behoben werden sollten.

  5. Ausführen des Upgrades: Nach der Überprüfung und Behebung von Problemen wird mithilfe des Cmdlets Invoke-AzUpgradeModulePlan das eigentliche Upgrade ausgeführt. Dieses Cmdlet kann vorhandene Dateien ändern oder Änderungen an neuen Dateien speichern, wobei _az_upgraded an Dateinamen angefügt wird, um die ursprünglichen Skripts beizubehalten. Diese zweite Methode gilt als sicherer.

Um eine reibungslose Migration zu gewährleisten, wird empfohlen, Skripts vor dem Ausführen von Upgrades zu sichern, da das Cmdlet Invoke-AzUpgradeModulePlan Daten löschen kann, wenn es nicht mit der Option -FileEditMode SaveChangesToNewFiles verwendet wird.

Benutzer*innen werden dazu ermutigt, Feedback zu geben oder Probleme mit dem Migrationsprozess über das GitHub-Repository azure-powershell-migration zu melden.