Az Azure PowerShell migrálása az AzureRM-ből az Az-be
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, már nem karbantartják és nem támogatják, így a folyamatos használat a felhasználó saját belátása és kockázata szerint történik. Az Az modulra való áttéréshez tekintse meg migrálási erőforrásainkat.
Állapítsa meg, hogy az AzureRM PowerShell-modult használja-e.
Az alábbi paranccsal állapítsa meg, hogy telepítve van-e az AzureRM PowerShell-modul:
Get-Module -Name AzureRM -ListAvailable
A szkriptek teljes szövegében is kereshet a *-AzureRM* minta alapján, hogy megállapítsa, valamelyikük használja-e az AzureRM PowerShell-modult.
Frissítés az Az PowerShell-modulra
Az AzureRM-parancsmagokhoz írt szkriptek nem működnek automatikusan az Az-val. Az áttérés megkönnyítése érdekében az AzureRM és az Az migrálási eszközkészletet fejlesztettük ki. Az új parancskészletre való migrálás soha nem kényelmes, de ez a cikk segít az Az PowerShell-modulra való áttérés megkezdésében. Az Az PowerShell-modul létrehozásának okairól az Az PowerShell-modul bemutatásacímű témakörben olvashat bővebben.
Az új parancsmagok nevei könnyen elsajátíthatóak. A parancsmagnevekben AzureRm vagy Azure helyett használja a Az. A régi New-AzureRMVm parancsmag például New-AzVmlett.
A migrálás azonban több, mint az új parancsmagok neveinek megismerése. Vannak átnevezett modulok, paraméterek és egyéb fontos változások.
Az AzureRM és az Az közötti kompatibilitástörő változások teljes listájának megtekintéséhez tekintse meg az AzureRM és az Az közöttiteljes módosításokat.
Győződjön meg arról, hogy a meglévő szkriptek a legújabb AzureRM-kiadással működnek
A migrálási lépések elvégzése előtt határozza meg, hogy az AzureRM mely verziói vannak telepítve a rendszeren. Így meggyőződhet arról, hogy a szkriptek már futnak a legújabb kiadásban, és tudassa, hogy az AzureRM mely verzióit kell eltávolítani.
Az AzureRM telepített verzióinak meghatározásához futtassa az alábbi példát:
Get-Module -Name AzureRM -ListAvailable -All
Az AzureRM legújabb elérhető kiadása 6.13.2. Ha nincs telepítve ez a verzió, előfordulhat, hogy a meglévő szkriptek további módosításokra szorulnak az Az modul használatához, túl azon, amit ebben a cikkben és a kompatibilitástörő módosítások listájánál leírtunk.
Ha a szkriptek nem működnek az AzureRM 6.13.2-vel, frissítse őket az AzureRM 5.x-ről 6.x-re történő migrálási útmutató szerint. Ha az AzureRM-modul egy korábbi verzióját használja, mindegyik főverzióhoz rendelkezésre állnak áttelepítési útmutatók.
1. lehetőség (ajánlott): A PowerShell-szkriptek automatikus migrálása
Ez az ajánlott beállítás minimálisra csökkenti az AzureRM-szkriptek Az-be való migrálásához szükséges erőfeszítést.
Az AzureRM-ről az Az-ra való migrálási eszközkészlettel létrehozhat egy tervet, amely meghatározza, hogy milyen módosítások lesznek végrehajtva a szkripteken, mielőtt módosítanák azokat, és mielőtt telepíti az Az PowerShell-modult.
Az PowerShell-szkriptek automatikus migrálása az AzureRM-ből az Az PowerShell-modulba rövid útmutató végigvezeti a PowerShell-szkriptek AzureRM-ből az Az PowerShell-modulba való automatikus frissítésének teljes folyamatán.
2. lehetőség: A kompatibilitási mód használata Enable-AzureRmAlias-vel
Az Az modul kompatibilitási móddal segíti a meglévő szkriptek használatát az új szintaxisra való frissítés során. Az Enable-AzureRmAlias parancsmag aliasokon keresztül teszi lehetővé a kompatibilitási módot. Ez a mód lehetővé teszi a meglévő szkriptek minimális módosítással történő használatát, miközben az Az-be való teljes migráláson dolgozik. Alapértelmezés szerint Enable-AzureRmAlias csak az aktuális PowerShell-munkamenet kompatibilitási aliasát engedélyezi. A Scope paraméter használatával megőrizheti a kompatibilitási aliasokat a PowerShell-munkamenetekben. További információért lásd a Enable-AzureRmAlias referenciadokumentációt.
Fontos
Annak ellenére, hogy a parancsmagok nevei aliasosak, előfordulhat, hogy az Az parancsmagok új (vagy átnevezett) paramétereket vagy módosított visszatérési értékeket tartalmaznak. Ne számítson arra, hogy az aliasok intézik el a migrálást ön helyett. Nézd meg a teljes kompatibilitástörő módosítások listáját, hogy megtudd, hol igényelhetnek a szkriptek frissítéseket.
A Enable-AzureRmAlias támogatása nem fog megszűnni az AzureRM PowerShell-modul elavulása miatt.
