Delen via

Azure PowerShell migreren van AzureRM naar Az

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Bepalen of u de AzureRM PowerShell-module gebruikt

Gebruik de volgende opdracht om te bepalen of de AzureRM PowerShell-module is geïnstalleerd:

Get-Module -Name AzureRM -ListAvailable

U kunt ook zoeken in volledige tekst van uw scripts voor het patroon *-AzureRM* om te bepalen of een van deze scripts gebruikmaakt van de AzureRM PowerShell-module.

Upgrade uitvoeren naar de Az PowerShell-module

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. Hoewel een migratie naar een nieuwe opdrachtenset nooit gemakkelijk is, zal dit artikel u helpen starten met het migreren naar de Az PowerShell-module. Zie Inleiding tot de Az PowerShell-module voor meer informatie over waarom de Az PowerShell-module is gemaakt.

De namen van de nieuwe cmdlets zijn zodanig ontworpen dat u ze gemakkelijk kunt onthouden. Gebruik AzureRmin plaats van Azure of Az te gebruiken in cmdlet-namen. De oude cmdlet New-AzureRMVm wordt nu bijvoorbeeld New-AzVm. Migratie is echter meer dan vertrouwd raken met 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-release

Voordat u migratiestappen uitvoert, moet u bepalen welke versies van AzureRM op uw systeem zijn geïnstalleerd. Hierdoor kunt u ervoor zorgen dat scripts al worden uitgevoerd in de nieuwste versie en u laten weten welke versies van AzureRM moeten worden verwijderd.

Voer het volgende voorbeeld uit om te bepalen welke versies 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 ze 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.

Met de AzureRM naar Az-migratie-toolkit kunt u een plan genereren om te bepalen welke wijzigingen worden uitgevoerd op uw scripts voordat u wijzigingen aanbrengt en voordat u de Az PowerShell-module installeert.

De PowerShell-scripts automatisch migreren van AzureRM naar de Az PowerShell-module quickstart begeleidt u bij het hele proces van het automatisch bijwerken van uw PowerShell-scripts van AzureRM naar de Az PowerShell-module.

Optie 2: 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. Met deze modus kunt u bestaande scripts met minimale aanpassingen gebruiken terwijl u werkt aan een volledige migratie naar Az. Standaard schakelt Enable-AzureRmAlias alleen compatibiliteitsaliassen in voor de huidige PowerShell-sessie. Gebruik de parameter Scope om compatibiliteitsaliassen in PowerShell-sessies te behouden. Zie de naslagdocumentatie voor Enable-AzureRmAlias voor meer informatie.

Belangrijk

Hoewel de cmdlet-namen alias zijn, zijn er mogelijk nog steeds nieuwe (of hernoemde) parameters of gewijzigde retourwaarden voor de Az-cmdlets. Verwacht niet dat het inschakelen van aliassen de migratie voor u zal afhandelen. Zie de volledige lijst van brekende wijzigingen om te bepalen waar uw scripts mogelijk moeten worden bijgewerkt.

Ondersteuning voor Enable-AzureRmAlias wordt niet afgeschaft met de afschaffing van de AzureRM PowerShell-module.

Volgende stappen