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

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

Von Bedeutung

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

Microsoft hat Az.Tools.Migration als Reaktion auf Kundenfeedback eingeführt, insbesondere hinsichtlich des Aufwands zum Aktualisieren von Skripts, die ursprünglich für AzureRM geschrieben wurden. Erkennend, dass viele Kunden in die Erstellung komplexer Skripts für Azure-Umgebungen investiert haben, wurde Az.Tools.Migration erstellt, um den Migrationsprozess zu optimieren und zu automatisieren, wodurch die manuelle Arbeitsauslastung und das Fehlerpotenzial bei Skriptupgrades reduziert werden.

So verwenden Sie das Az.Tools.Migration-Modul

Der Prozess der Verwendung von Az.Tools.Migration umfasst mehrere Schritte:

1. Aktualisieren auf AzureRM, Version 6.13.1: Bevor Sie Az.Tools.Migration verwenden, müssen Benutzer sicherstellen, dass ihre Skripts auf AzureRM Version 6.13.1 aktualisiert werden, die letzte Version vor der Migration zum Az-Modul .

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

3. Generieren eines Upgradeplans: Das New-AzUpgradeModulePlan Cmdlet generiert einen Upgradeplan. Vorhandene Skripts werden nicht geändert, sondern ein Upgradepfad bereitgestellt, indem ein Plan erstellt wird, der bestimmte Dateien und Offsetpunkte enthält, die Aktualisierungen erfordern. Dieses Cmdlet verwendet Parameter wie FilePath und DirectoryPath , um bestimmte Skripts oder Ordner als Ziel festzulegen.

4. Überprüfen des Upgradeplans: Bevor Sie das Upgrade ausführen, ist es wichtig, den Plan für potenzielle Probleme zu überprüfen, die automatische Upgrades verhindern können, z. B. Befehle, die Splatting verwenden, und bei Bedarf manuell korrigieren.

5. Durchführen des Upgrades: Nach dem Überprüfen und Beheben von Problemen wird das eigentliche Upgrade mit dem Invoke-AzUpgradeModulePlan Cmdlet ausgeführt. Dieses Cmdlet kann entweder vorhandene Dateien ändern oder, als sicherere Option, Änderungen an neuen Dateien speichern, an deren Namen _az_upgraded angefügt wurde, um die ursprünglichen Skripte zu erhalten.

Um eine reibungslose Migration sicherzustellen, empfiehlt es sich, Skripts vor dem Ausführen von Upgrades zu sichern, da das Invoke-AzUpgradeModulePlan Cmdlet destruktiv sein kann, wenn es nicht mit der -FileEditMode SaveChangesToNewFiles Option verwendet wird.

Benutzer werden ermutigt, Feedback zu geben oder Probleme mit dem Migrationsprozess im GitHub-Repository für azure-powershell-Migration zu melden.