Sdílet prostřednictvím

Migrace Azure PowerShellu z AzureRM na Az

  • Článek

Varování

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ž veškeré další použití je na uvážení a riziko uživatele. Pokyny k přechodu na modul Az najdete v našich prostředcích pro 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 úplné textové vyhledávání svých skriptů na výskyt vzoru *-AzureRM*, abyste zjistili, jestli některý z nich používá modul AzureRM PowerShell.

Aktualizujte modul Az PowerShell

Skripty napsané pro rutiny AzureRM nebudou s Az automaticky fungovat. Pro usnadnění přechodu byla vyvinuta sada nástrojů pro migraci AzureRM na Az. Migrace na novou sadu příkazů není nikdy pohodlná, ale tento článek vám pomůže začít s přechodem na modul Az PowerShell. Další informace o tom, proč byl modul Az PowerShell vytvořen, najdete v tématu Představujeme modul Az PowerShell.

Nové názvy rutin byly navrženy tak, aby se je bylo snadné naučit. Místo použití AzureRm nebo Azure v názvech rutin použijte Az. Například starý cmdlet New-AzureRMVm se změnil na New-AzVm. Migrace je ale víc než seznámení s novými názvy rutin. Existují přejmenované moduly, parametry a další důležité změny.

Úplný seznam zásadních změn mezi AzureRM a Az najdete v úplných změn z AzureRM na Az.

Ujistěte se, že stávající skripty fungují s nejnovější 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ěží na nejnovějším vydání, a zjistit, které verze AzureRM je nutné 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 tuto verzi nemáte nainstalovanou, vaše stávající skripty můžou potřebovat další úpravy pro práci s modulem Az nad rámec toho, co je popsáno v tomto článku, a v seznamu zásadních změn.

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, jsou pro každou hlavní verzi k dispozici průvodce migrací.

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

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

Rychlý průvodce automatickou migrací skriptů PowerShell z AzureRM do modulu Az PowerShell vás provede celým procesem automatické aktualizace skriptů PowerShell 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 pomůže při aktualizaci na novou syntaxi použít existující skripty. Rutina Enable-AzureRmAlias umožňuje režim kompatibility prostřednictvím aliasů. Tento režim umožňuje používat existující skripty s minimálními úpravami při práci na úplnou migraci na Az. Ve výchozím nastavení Enable-AzureRmAlias povolí aliasy kompatibility jenom pro aktuální relaci PowerShellu. K zachování aliasů kompatibility napříč relacemi PowerShellu použijte jeho Scope parametr. Další informace najdete v referenční dokumentaci Enable-AzureRmAlias .

Důležitý

I když jsou názvy cmdletů aliasované, mohou se stále objevovat nové (nebo přejmenované) parametry nebo změněné návratové hodnoty pro cmdlety Az. Neočekávejte, že se zapnutí aliasů postará o migraci za vás. Podívejte se na seznam podstatných změn a zjistěte, kde mohou vaše skripty vyžadovat aktualizace.

Podpora pro Enable-AzureRmAlias nebude ukončena s vyřazením modulu AzureRM PowerShell.

Další kroky