Azure PowerShell migreren van AzureRM naar Az

  • Artikel
  • 4 minuten om te lezen

Alle versies van de Azure RM PowerShell-module zijn verouderd. De Az PowerShell-module is nu de aanbevolen PowerShell-module voor interactie met Azure.

Belangrijk

Omdat Az PowerShell-modules nu alle mogelijkheden van AzureRM PowerShell-modules hebben en meer, wordt AzureRM PowerShell-modules op 29 februari 2024 buiten gebruik gesteld.

Als u serviceonderbrekingen wilt voorkomen, moet u uw scripts bijwerken die gebruikmaken van AzureRM PowerShell-modules voor het gebruik van Az PowerShell-modules op 29 februari 2024. Volg de snelstartgids om uw scripts automatisch bij te werken.

Waarom een nieuwe module?

De grootste en belangrijkste wijziging is dat PowerShell sinds de introductie van PowerShell, dat is gebaseerd op de .NET Standard-bibliotheek, een platformoverschrijdend product is.

Net als bij de PowerShell-taal streven we ernaar om ondersteuning voor Azure naar alle platforms te brengen. Onze toewijding betekent dat de Azure PowerShell-modules moeten worden bijgewerkt om gebruik te maken van .NET Standard en dat ze compatibel moeten zijn met PowerShell Core. In plaats van deze ondersteuning toe te voegen door de bestaande AzureRM-module weer te bewerken en daar complexe wijzigingen in te door te voeren, hebben we de Az-module gemaakt.

Door een nieuwe module te maken, konden onze technici ook het ontwerp en de naamgeving van cmdlets en modules consistent maken. Alle modules beginnen nu met het voorvoegsel Az. en cmdlets gebruiken allemaal de naamconventie Verb-AzNoun. Eerder waren namen van cmdlets langer en inconsistent.

Het aantal modules is ook teruggedrongen: Enkele modules die met dezelfde services werden gebruikt, zijn gecombineerd. Cmdlets voor het beheervlak en gegevensvlak voor dezelfde service zijn nu opgenomen in een enkele module. Mensen die handmatig afhankelijkheden en imports beheren, krijgen het door deze samenvoeging een stuk makkelijker.

Door deze belangrijke wijzigingen door te voeren, laat het team zien dat het er alles aan doet om het eenvoudiger dan ooit te maken om Azure met PowerShell-cmdlets te gebruiken, en om dit op meer platforms dan ooit mogelijk te maken.

Upgraden naar Az PowerShell

Scripts die zijn geschreven voor de AzureRM-cmdlets werken niet automatisch met Az. De toolkit voor migratie van AzureRM naar Az is ontwikkeld om de overgang gemakkelijker te maken. Migreren naar een nieuwe opdrachtset is nooit fijn, maar in dit artikel helpen we u aan de slag met de overgang naar de Az PowerShell-module. Zie Introductie van de nieuwe Az-module van Azure PowerShell voor meer informatie over waarom de Az-module voor PowerShell is gemaakt.

De namen van de nieuwe cmdlets zijn zodanig ontworpen dat u ze gemakkelijk kunt onthouden. In plaats van AzureRm of Azure gebruikt u Az in cmdlet-namen. De oude cmdlet New-AzureRMVm wordt nu bijvoorbeeld New-AzVm. Migratie houdt echter meer in dan alleen het leren kennen van de nieuwe cmdlet-namen. er zijn namelijk hernoemde modules, parameters en andere belangrijke wijzigingen.

Voor de volledige lijst met belangrijke wijzigingen tussen AzureRM en Az raadpleegt u Alle wijzigingen tussen AzureRM en Az.

Zorg ervoor dat bestaande scripts werken met de nieuwste AzureRM-versie

Controleer voordat u migratiestappen onderneemt welke versies van AzureRM op uw systeem zijn geïnstalleerd. Zo zorgt u ervoor dat scripts volgens de nieuwste versie worden uitgevoerd en komt u te weten welke versies van AzureRM moeten worden verwijderd.

Voer het volgende voorbeeld uit om te kijken welke versie(s) van AzureRM u hebt geïnstalleerd:

Get-Module -Name AzureRM -ListAvailable -All

De nieuwste beschikbare versie van AzureRM is 6.13.2. Als u deze versie niet hebt geïnstalleerd, hebben uw bestaande scripts mogelijk extra aanpassingen nodig om met de Az-module te werken, aanvullend op wat in dit artikel en in de lijst met belangrijke wijzigingen is beschreven.

Als uw scripts niet werken met AzureRM 6.13.2, werkt u deze bij volgens de migratiehandleiding van AzureRM 5.x naar 6.x. Als u een eerdere versie van de AzureRM-module gebruikt, zijn er voor elke belangrijke versie migratiehandleidingen beschikbaar.

Deze aanbevolen optie minimaliseert de inspanning die nodig is om AzureRM-scripts te migreren naar Az.

De toolkit voor migratie van AzureRM naar Az installeren

Install-Module -Name Az.Tools.Migration

Uw scripts automatisch converteren

Met de AzureRM naar AZ Migration Toolkit kunt u een plan genereren om te bepalen welke wijzigingen op uw scripts worden uitgevoerd voordat u wijzigingen aanbrengt en voordat u de AZ Power shell-module installeert.

Met de quickstart PowerShell-scripts automatisch migreren van AzureRM naar de Az-module voor PowerShell gaat u door het hele proces om PowerShell-scripts automatisch bij te werken van AzureRM naar de Az PowerShell-module.

Optie 2: De compatibiliteitsmodus gebruiken met Enable-AzureRmAlias

De Az-module beschikt over een compatibiliteitsmodus waarmee u bestaande scripts kunt gebruiken terwijl u bijwerkt naar de nieuwe syntax. Met de cmdlet Enable-AzureRmAlias wordt compatibiliteit via aliassen ingeschakeld. In deze modus kunt u bestaande scripts gebruiken met minimale beperking, terwijl u naar een volledige migratie naar Az toewerkt. Standaard worden in Enable-AzureRmAlias alleen compatibiliteitsaliassen voor de huidige PowerShell-sessie ingeschakeld. Gebruik de parameter Scope om compatibiliteitsaliassen persistent te maken tussen PowerShell-sessies. Zie de naslagdocumentatie voor Enable-AzureRmAlias voor meer informatie.

Belangrijk

Hoewel de cmdlet-namen aliassen zijn, kunnen er nog steeds nieuwe (of hernoemde) parameters of gewijzigde retourwaarden voor de Az-cmdlets zijn. Verwacht niet dat ingeschakelde aliassen de migratie voor u kunnen verzorgen! Zie de volledige lijst met wijzigingen die fouten veroorzaken om te zien waar uw scripts mogelijk moeten worden bijgewerkt.

Optie 3: Uw scripts migreren in Visual Studio Code met de nieuwe Azure PowerShell-extensie

Installeer de Azure PowerShell-extensie voor Visual Studio Code

De Azure PowerShell-extensie voor VSCode installeren

Uw scripts handmatig converteren

  1. Uw AzureRM-script laden in VSCode
  2. De migratie beginnen door het opdrachtenpalet Ctrl+Shift+P te openen en Migrate Azure PowerShell script te selecteren
  3. Bronversie AzureRM selecteren
  4. Volg de aanbevolen acties voor elke onderstreepte opdracht of parameter.

Volgende stappen