Migrera Azure PowerShell från AzureRM till Az

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.

Alternativ 1 (rekommenderas): Migrera dina PowerShell-skript automatiskt

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.

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

Nästa steg

• Migrera PowerShell-skript automatiskt
• Introduktion till Az PowerShell-modulen
• Ändringar mellan AzureRM och Az
• Installera Az PowerShell-modulen
• Avinstallera AzureRM