Migrace Azure PowerShellu z AzureRM na Az

  • Článek

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Určení, jestli používáte modul AzureRM PowerShellu

Pomocí následujícího příkazu zjistěte, jestli máte nainstalovaný modul AzureRM PowerShellu:

Get-Module -Name AzureRM -ListAvailable

Můžete také provést fulltextové vyhledávání vašich skriptů, *-AzureRM* abyste zjistili, jestli některý z nich používá modul AzureRM PowerShellu.

Upgrade na modul Az PowerShell

Skripty napsané pro AzureRM nebudou automaticky fungovat s modulem Az. Aby byl přechod jednodušší, vyvinuli jsme sadu nástrojů pro migraci z AzureRM na Az. Migrace na novou sadu příkazů není nikdy nic příjemného, ale tento článek vám pomůže začít s přechodem na modul Az PowerShell. Další informace o tom, proč se vytvořil modul Az PowerShell, najdete v tématu Úvod k modulu Az PowerShell.

Nové názvy rutin jsou navržené tak, aby se dobře pamatovaly. Místo použití AzureRm nebo Azure v názvech rutin použijte Az. Například ze staré rutiny New-AzureRMVm se stala rutina New-AzVm. Migrace je ale víc než seznámení s novými názvy rutin. Dochází k přejmenování modulů, parametrů a dalším důležitým změnám.

Úplný seznam všech zásadních změn mezi AzureRM a Az najdete v tématu Všechny změny mezi AzureRM a Az.

Kontrola, že stávající skripty fungují s nejnovější vydanou verzí AzureRM

Před provedením jakýchkoli kroků migrace určete, které verze AzureRM jsou ve vašem systému nainstalované. Díky tomu se můžete ujistit, že skripty už běží v nejnovější verzi, a dejte vědět, jaké verze AzureRM je potřeba odinstalovat.

Pokud chcete zjistit, které verze AzureRM máte nainstalované, spusťte následující příklad:

Get-Module -Name AzureRM -ListAvailable -All

Nejnovější dostupná verze AzureRM je 6.13.2. Pokud nemáte nainstalovanou tuto verzi, vaše stávající skripty můžou vyžadovat další úpravy nad rámec informací uvedených v tomto článku a informací v seznamu zásadních změn, aby fungovaly s modulem Az.

Pokud vaše skripty nefungují s AzureRM 6.13.2, aktualizujte je podle průvodce migrací AzureRM 5.x na 6.x. Pokud používáte starší verzi modulu AzureRM, průvodci migrací jsou k dispozici pro každou hlavní verzi.

Tato doporučená možnost minimalizuje úsilí potřebné k migraci skriptů AzureRM do Az.

Pomocí sady nástrojů pro migraci z AzureRM na Az můžete před úpravami vašich skriptů a instalací modulu Az PowerShell vygenerovat plán, který určí, jaké změny se budou ve vašich skriptech provádět.

Rychlý start Automatická migrace skriptů PowerShellu z AzureRM na modul Az PowerShell vás provede celým procesem automatické aktualizace skriptů PowerShellu z AzureRM na modul Az PowerShell.

Možnost 2: Použití režimu kompatibility s enable-AzureRmAlias

Modul Az má režim kompatibility, který vám v době, kdy aktualizujete na novou syntaxi, pomůže využívat stávající skripty. Rutina Enable-AzureRmAlias povoluje režim kompatibility prostřednictvím aliasů. Tento režim umožňuje během práce na úplné migraci do Az používat stávající skripty s minimálními úpravami. Ve výchozím nastavení Enable-AzureRmAlias povoluje jenom aliasy kompatibility pro aktuální relaci PowerShellu. Jeho parametr Scope použijte k zachování aliasů kompatibility napříč relacemi PowerShellu. Další informace najdete v referenční dokumentaci k Enable-AzureRmAlias.

Důležité

Přestože pro názvy rutin existují aliasy, pro rutiny Az stále můžou existovat nové (nebo přejmenované) parametry nebo změněné vracené hodnoty. Neočekávejte, že se povolení aliasů postará o migraci za vás. Projděte si úplný seznam zásadních změn a zjistěte, které části vašich skriptů můžou vyžadovat aktualizace.

Podpora pro Enable-AzureRmAlias vyřazení modulu AzureRM PowerShell nebude zastaralá.

Další kroky