Overzicht van de PowerShell-module Az.Tools.Migration

De PowerShell-module Az.Tools.Migration faciliteert de overgang van de oudere AzureRM-module naar de nieuwere Az-module , die wordt aanbevolen voor Azure-beheer.

Belangrijk

De AzureRM PowerShell-module is vanaf 29 februari 2024 afgeschaft.

Microsoft heeft Az.Tools.Migration geïntroduceerd in reactie op feedback van klanten, met name wat betreft de inspanningen die nodig zijn om scripts bij te werken die oorspronkelijk zijn geschreven voor AzureRM. Aangezien veel klanten hebben geïnvesteerd in het maken van complexe scripts voor Azure-omgevingen, is Az.Tools.Migration gemaakt om het migratieproces te stroomlijnen en automatiseren, waardoor de handmatige workload en het potentieel voor fouten tijdens scriptupgrades worden verminderd.

De Az.Tools.Migration-module gebruiken

Het proces voor het gebruik van Az.Tools.Migration omvat verschillende stappen:

1. Bijwerken naar AzureRM versie 6.13.1: Voordat ze Az.Tools.Migration gebruiken, moeten gebruikers ervoor zorgen dat hun scripts worden bijgewerkt naar AzureRM versie 6.13.1, de laatste versie vóór de migratie naar de Az-module.

2. Az.Tools.Migration installeren: de module kan worden geïnstalleerd vanuit de PowerShell Gallery met de Install-Module -Name Az.Tools.Migration opdracht.

3. Een upgradeplan genereren: de New-AzUpgradeModulePlan cmdlet genereert een upgradeplan. Bestaande scripts worden niet gewijzigd, maar biedt een upgradepad door een plan te maken waarin specifieke bestanden en offsetpunten worden beschreven waarvoor updates zijn vereist. Deze cmdlet gebruikt parameters zoals FilePath en DirectoryPath om specifieke scripts of mappen te targeten.

4. Het upgradeplan controleren: voordat u de upgrade uitvoert, is het van cruciaal belang om het plan te controleren op mogelijke problemen die automatische upgrades kunnen voorkomen, zoals opdrachten die splatting gebruiken, en deze indien nodig handmatig corrigeren.

5. De upgrade uitvoeren: na het controleren en oplossen van eventuele problemen, wordt de daadwerkelijke upgrade uitgevoerd met behulp van de Invoke-AzUpgradeModulePlan cmdlet. Met deze cmdlet kunt u bestaande bestanden wijzigen of, veiliger, wijzigingen opslaan in nieuwe bestanden die _az_upgraded aan hun namen zijn toegevoegd om de oorspronkelijke scripts te behouden.

Om een soepele migratie te garanderen, is het raadzaam om een back-up te maken van scripts voordat u upgrades uitvoert, omdat de cmdlet destructief kan zijn als deze Invoke-AzUpgradeModulePlan niet met de -FileEditMode SaveChangesToNewFiles optie wordt gebruikt.

Gebruikers worden aangemoedigd om feedback te geven of problemen te melden met het migratieproces in de GitHub-opslagplaats voor azure-powershell-migration.