Az Azure PowerShell migrálása az AzureRM modulból az Az modulba
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, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Annak megállapítása, 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 mintához *-AzureRM* tartozó szkriptek teljes szöveges keresését is elvégezheti annak megállapításához, hogy valamelyikük az AzureRM PowerShell-modult használja-e.
Frissítés az Az PowerShell-modulra
Az AzureRM-parancsmagokhoz írt szkriptek nem működnek automatikusan az Az modullal. A váltás megkönnyítése érdekében lett kifejlesztve az AzureRM és Az közötti migrálási eszközkészlet. Az új parancskészletekre való áttérés soha nem egyszerű, ebben a cikkben azonban segítünk megismerkedni az Az PowerShell-modulra való átállás alapjaival. Az Az PowerShell-modul létrehozásának okairól az Az PowerShell-modul bemutatása című témakörben olvashat bővebben.
Az új parancsmagnevek úgy lettek kidolgozva, hogy könnyen megjegyezhetők legyenek. A parancsmagnevekben az AzureRm és az Azure helyett az Az használható. Például a régi New-AzureRMVm parancs megfelelője a New-AzVm parancs lett.
A migrálás azonban több, mint az új parancsmagok neveinek megismerése. Vannak átnevezett modulok, paraméterek és más fontos változások is.
Az AzureRM és az Az közötti kompatibilitástörő változások teljes listáját az AzureRM és az Az közötti változások teljes listájában találja.
Annak ellenőrzése, hogy a meglévő szkriptek működnek-e az AzureRM legújabb kiadásával
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 a 6.13.2. Ha nincs telepítve ez a verzió, a meglévő szkriptek további módosítást is igényelhetnek az ebben a cikkben és a kompatibilitástörő változások listájában leírtakon túlmenően, hogy használni lehessen őket az Az modullal.
Ha a szkriptek nem működnek az AzureRM 6.13.2-vel, frissítse őket az AzureRM 5.x és 6.x áttelepítési útmutatója szerint. Ha az AzureRM modul korábbi verzióját használja, mindegyik fő verzióhoz elérhető migrálási útmutató.
1. lehetőség (ajánlott): A PowerShell-szkriptek automatikus migrálása
Ez az ajánlott lehetőség minimálisra csökkentheti az AzureRM-szkriptek az Az-ba való migrálásához szükséges erőfeszítést.
Az AzureRM és Az közötti migrálási eszközkészlettel létrehozhat egy tervet, amely megállapítja, milyen módosításokat kell végrehajtani a szkripteken, mielőtt valóban módosítaná azokat és telepítené az Az PowerShell-modult.
A PowerShell-szkriptek az AzureRM modulból az Az PowerShell-modulba történő automatikus migrálásának gyorsútmutatója végigvezet a PowerShell-szkriptek AzureRM-ből az Az PowerShell-modulba való automatikus frissítésének teljes folyamatán.
2. lehetőség: Kompatibilitási mód használata az Enable-AzureRmAlias használatával
Az Az modul kompatibilitási módjával továbbra is használhatja a meglévő szkripteket az új szintaxis frissítése közben. Az Enable-AzureRmAlias parancsmag aliasok segítségével kompatibilitási módot biztosít. Ez az üzemmód lehetővé teszi a meglévő szkriptek minimális módosítással történő használatát, míg az Az-be történő teljes migráláson dolgozik. Alapértelmezés szerint az Enable-AzureRmAlias a kompatibilitási aliasokat csak az aktuális PowerShell-munkamenethez engedélyezi. Használja a Scope paraméterét a kompatibilitási aliasok PowerShell-munkamenetek közötti megtartásához. További információ az Enable-AzureRmAlias referenciadokumentációjában található.
Fontos
Annak ellenére, hogy a parancsmagok aliasnévvel rendelkeznek, az Az-parancsmagoknak lehetnek új (vagy átnevezett) paraméterei, illetve módosított visszaadott értékei. Ne várja el, hogy az aliasok gondoskodjanak a migrálásról. Tekintse meg a kompatibilitástörő változások teljes listáját, amelyből megtudhatja, hol lehet szükség a szkriptek frissítésére.
Enable-AzureRmAlias Az AzureRM PowerShell-modul elavulttá válik.
