Översikt över PowerShell-modulen Az.Tools.Migration

  • Artikel

Modulen Az.Tools.Migration PowerShell underlättar övergången från den äldre AzureRM-modulen till den nyare Az-modulen, vilket rekommenderas för Azure-hantering.

Viktigt!

AzureRM PowerShell-modulen är inaktuell från och med den 29 februari 2024.

Microsoft introducerade Az.Tools.Migration som svar på kundfeedback, särskilt när det gäller det arbete som krävdes för att uppdatera skript som ursprungligen skrevs för AzureRM. Az.Tools.Migration har skapats för att effektivisera och automatisera migreringsprocessen, vilket minskar den manuella arbetsbelastningen och risken för fel under skriptuppgraderingar, eftersom många kunder har investerat i att skapa komplexa skript för Azure-miljöer.

Så här använder du modulen Az.Tools.Migration

Processen med att använda Az.Tools.Migration omfattar flera steg:

  1. Uppdaterar till AzureRM version 6.13.1: Innan du använder Az.Tools.Migration måste användarna se till att deras skript uppdateras till AzureRM version 6.13.1, den sista versionen före migreringen till Az-modulen .

  2. Installera Az.Tools.Migration: Modulen kan installeras från PowerShell-galleriet med Install-Module -Name Az.Tools.Migration kommandot .

  3. Genererar en uppgraderingsplan: Cmdleten New-AzUpgradeModulePlan genererar en uppgraderingsplan. Det ändrar inte befintliga skript men tillhandahåller en uppgraderingssökväg genom att skapa en plan som beskriver specifika filer och förskjutningspunkter som kräver uppdateringar. Den här cmdleten tar parametrar som FilePath och DirectoryPath till specifika skript eller mappar.

  4. Granska uppgraderingsplanen: Innan du kör uppgraderingen är det viktigt att granska planen för eventuella problem som kan förhindra automatiska uppgraderingar, till exempel kommandon som använder splatting, och korrigera dem manuellt om det behövs.

  5. Utför uppgraderingen: När du har granskat och löst eventuella problem utförs den faktiska uppgraderingen med hjälp av cmdleten Invoke-AzUpgradeModulePlan . Den här cmdleten kan antingen ändra befintliga filer eller, på ett säkrare sätt, spara ändringar i nya filer med _az_upgraded läggs till i deras namn för att bevara de ursprungliga skripten.

För att säkerställa en smidig migrering rekommenderar vi att du säkerhetskopierar skript innan du utför uppgraderingar eftersom cmdleten kan vara destruktiv om den Invoke-AzUpgradeModulePlan-FileEditMode SaveChangesToNewFiles inte används med alternativet .

Användarna uppmanas att ge feedback eller rapportera problem med migreringsprocessen på GitHub-lagringsplatsen för azure-powershell-migrering.