Migrera Azure PowerShell från AzureRM till Az

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Ta reda på om du använder AzureRM PowerShell-modulen

Använd följande kommando för att avgöra om du har AzureRM PowerShell-modulen installerad:

Get-Module -Name AzureRM -ListAvailable

Du kan också utföra en fullständig textsökning av skripten efter mönstret *-AzureRM* för att avgöra om någon av dem använder AzureRM PowerShell-modulen.

Uppgradera till Az PowerShell-modulen

Skript som har skrivits för AzureRM-cmdlets fungerar inte automatiskt med Az. För att underlätta övergången utvecklades verktyg för migrering från AzureRM till AZ. Ingen migrering till en ny kommandouppsättning är någonsin läglig, men i den här artikeln får du hjälp att komma igång med övergången till Az PowerShell-modulen. Mer information om varför Az PowerShell-modulen skapades finns i Introduktion till Az PowerShell-modulen.

De nya cmdlet-namnen har utformats för att vara lätta att lära sig. I stället för att använda AzureRm eller Azure i cmdlet-namn använder du Az. Till exempel har den gamla cmdleten New-AzureRMVm blivit New-AzVm. Migreringen är dock mer än att bekanta sig med de nya cmdlet-namnen. Det finns omdöpta moduler, parametrar och andra viktiga ändringar.

En fullständig lista över icke-bakåtkompatibla ändringar mellan AzureRM och Az finns i de fullständiga ändringarna från AzureRM till Az.

Se till att befintliga skript fungerar med den senaste versionen av AzureRM

Innan du utför några migreringssteg ska du ta reda på vilka versioner av AzureRM som är installerade i systemet. På så sätt kan du se till att skript redan körs på den senaste versionen och låta dig veta vilka versioner av AzureRM som måste avinstalleras.

Kör följande exempel för att avgöra vilka versioner av AzureRM du har installerat:

Get-Module -Name AzureRM -ListAvailable -All

Den senaste tillgängliga versionen av AzureRM är 6.13.2. Om du inte har den här versionen kan de befintliga skripten behöva ytterligare modifieringar för att de ska fungera med Az-modulen, förutom det som beskrivs i den här artikeln och i listan över icke-bakåtkompatibla ändringar.

Om dina skript inte fungerar med AzureRM 6.13.2 uppdaterar du dem enligt migreringsguiden för AzureRM 5.x till 6.x. Om du använder en tidigare version av AzureRM-modulen finns det migreringsguider för varje större version.

Det här rekommenderade alternativet minimerar arbetet med att migrera AzureRM-skript till Az.

Med verktygen för migrering från AzureRM till Az kan du skapa en plan för att bestämma vilka ändringar som ska utföras för dina skript innan du ändrar dem och innan du installerar Az PowerShell-modulen.

Snabbstarten Migrera PowerShell-skript automatiskt från AzureRM till Az PowerShell-modulen vägleder dig genom hela processen med att uppdatera PowerShell-skript automatiskt från AzureRM till Az PowerShell-modulen.

Alternativ 2: Använd kompatibilitetsläge med Enable-AzureRmAlias

Az-modulen har ett kompatibilitetsläge för befintliga skript medan du arbetar med uppdateringar till den nya syntaxen. Cmdleten Enable-AzureRmAlias aktiverar ett kompatibilitetsläge via alias. Det här läget gör att du kan använda befintliga skript med minimal modifiering under tiden som du migrerar till Az. Som standard aktiverar Enable-AzureRmAlias bara kompatibilitetsalias för den aktuella PowerShell-sessionen. Använd dess Scope-parameter om du vill bevara kompatibilitetsalias mellan PowerShell-sessioner. Mer information finns i referensdokumentation för Enable-AzureRmAlias.

Viktigt!

Även om cmdlet-namnen har alias kan det finnas nya (eller omdöpta) parametrar och ändrade returvärden för Az-cmdletar. Förvänta dig inte att aktivera alias för att ta hand om migreringen åt dig. I den fullständiga listan över icke-bakåtkompatibla ändringar ser du var skripten kan kräva uppdateringar.

Stödet för Enable-AzureRmAlias kommer inte att bli inaktuellt med utfasningen av AzureRM PowerShell-modulen.

Nästa steg