Sdílet prostřednictvím

Přehled modulu Az.Tools.Migration PowerShellu

  • Článek

Modul Az.Tools.Migration PowerShell usnadňuje přechod ze staršího modulu AzureRM na novější modul Az , který se doporučuje pro správu Azure.

Důležité

Modul AzureRM PowerShell je od 29. února 2024 zastaralý.

Microsoft zavedl Az.Tools.Migration v reakci na zpětnou vazbu zákazníků, zejména pokud jde o úsilí potřebné k aktualizaci skriptů, které byly původně napsané pro AzureRM. Když si uvědomíte, že mnoho zákazníků investovalo do vytváření složitých skriptů pro prostředí Azure, vytvořilo se Az.Tools.Migration , které zjednodušilo a automatizovalo proces migrace, čímž se snížil počet ručních úloh a potenciál chyb při upgradu skriptů.

Jak používat modul Az.Tools.Migration

Proces použití Az.Tools.Migration zahrnuje několik kroků:

  1. Aktualizace na AzureRM verze 6.13.1: Před použitím Az.Tools.Migration musí uživatelé zajistit, aby se jejich skripty aktualizovaly na AzureRM verze 6.13.1, poslední verzi před migrací do modulu Az.

  2. Instalace Az.Tools.Migration: Modul lze nainstalovat z Galerie prostředí PowerShell pomocí Install-Module -Name Az.Tools.Migration příkazu.

  3. Generování plánu upgradu: Rutina New-AzUpgradeModulePlan vygeneruje plán upgradu. Nemění existující skripty, ale poskytuje cestu upgradu tak, že vytvoří plán s podrobnostmi o konkrétních souborech a bodech posunu vyžadujících aktualizace. Tato rutina přebírá parametry, jako jsou FilePath a DirectoryPath , aby cílily na konkrétní skripty nebo složky.

  4. Kontrola plánu upgradu: Před provedením upgradu je důležité zkontrolovat plán potenciálních problémů, které můžou bránit automatickým upgradům, jako jsou příkazy, které používají splatting, a v případě potřeby je opravit ručně.

  5. Provedení upgradu: Po kontrole a řešení jakýchkoli problémů se skutečný upgrade provádí pomocí rutiny Invoke-AzUpgradeModulePlan . Tato rutina může buď upravit existující soubory, nebo bezpečněji uložit změny nových souborů s připojenými _az_upgraded k jejich názvům, aby se zachovaly původní skripty.

Pokud chcete zajistit bezproblémovou migraci, doporučujeme před upgradem zálohovat skripty, protože rutina Invoke-AzUpgradeModulePlan může být destruktivní, pokud se s -FileEditMode SaveChangesToNewFiles možností nepoužívá.

Uživatelům se doporučuje poskytnout zpětnou vazbu nebo nahlásit problémy s procesem migrace v úložišti GitHub pro migraci azure-powershell-migration.