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, a další používání je na uvážení a riziko uživatele. Pokyny k přechodu na modul Az najdete v našich migračních materiálech .

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í skriptů pro vzor *-AzureRM*, abyste určili, jestli některý z nich používá modul AzureRM PowerShell.

Aktualizovat 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 daly snadno naučit. Místo použití AzureRm nebo Azure v názvech rutin použijte Az. Například starý cmdlet New-AzureRMVm se stal 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 změnách 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ěží v nejnovější verzi, a zjistit, jaké verze AzureRM musí být odinstalovány.

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.

Automaticky migrovat skripty PowerShellu z AzureRM do modulu Az PowerShell, rychlý průvodce 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 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é, stále se mohou vyskytovat nové (nebo přejmenované) parametry nebo změněné návratové hodnoty pro cmdlety Az. Neočekávejte, že povolení aliasů zařídí migraci za vás. Podívejte se na seznam zásadních změn a zjistěte, kde můžou vaše skripty vyžadovat aktualizace.

Podpora pro Enable-AzureRmAlias nebude ukončena, i když dojde k ukončení podpory pro modul AzureRM PowerShell.

Další kroky