Dela via

Migrera Azure PowerShell från AzureRM till Az

  • Artikel

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 skrivits för AzureRM-cmdletarna fungerar inte automatiskt med Az. För att göra övergången enklare utvecklades AzureRM till Az-migreringsverktyg. Det går aldrig att migrera till en ny kommandouppsättning, men den här artikeln hjälper dig 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. Migrering handlar dock om 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 oförenliga ändringar mellan AzureRM och Az finns i alla ändringar från AzureRM till Az.

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

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 installerad kan dina befintliga skript behöva ytterligare ändringar för att fungera med Az-modulen utöver vad som beskrivs i den här artikeln och i listan över väsentliga ändringar .

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

Det här rekommenderade alternativet minimerar det arbete som krävs för att migrera AzureRM-skript till Az.

Med migreringsverktygen AzureRM till Az kan du skapa en plan för att avgöra vilka ändringar som ska utföras på skripten innan du gör några ändringar i dem och innan du installerar Az PowerShell-modulen.

I Migrera PowerShell-skript automatiskt från AzureRM till Az PowerShell-modulen snabbstart går vi igenom hela processen med att automatiskt uppdatera dina PowerShell-skript från AzureRM till Az PowerShell-modulen.

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

Az-modulen har ett kompatibilitetsläge som hjälper dig att använda befintliga skript när du uppdaterar till den nya syntaxen. Cmdleten Enable-AzureRmAlias möjliggör ett kompatibilitetsläge via alias. Med det här läget kan du använda befintliga skript med minimal ändring när du arbetar mot en fullständig migrering till Az. Som standard aktiverar Enable-AzureRmAlias endast kompatibilitetsalias för den aktuella PowerShell-sessionen. Använd parametern Scope för att bevara kompatibilitetsalias i PowerShell-sessioner. Mer information finns i Enable-AzureRmAlias referensdokumentationen.

Viktig

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

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

Nästa steg