Delen via

Azure PowerShell migreren van AzureRM naar Az

  • Artikel

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. Om de overgang eenvoudiger te maken, is de AzureRM naar Az Migration Toolkit ontwikkeld. 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-modulevoor meer informatie over waarom de Az PowerShell-module is gemaakt.

De nieuwe cmdlet-namen zijn ontworpen om eenvoudig te leren. Gebruik Azin plaats van AzureRm of Azure te gebruiken in cmdlet-namen. De oude cmdlet New-AzureRMVm is bijvoorbeeld New-AzVmgeworden. Migratie is echter meer dan vertrouwd raken met de nieuwe cmdlet-namen. Er zijn hernoemde modules, parameters en andere belangrijke wijzigingen.

Zie de volledige lijst met wijzigingen van AzureRM naar Azvoor belangrijke 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 aanvullende wijzigingen nodig om met de Az-module te werken, buiten het bereik van wat in dit artikel wordt beschreven en in de lijst met belangrijke wijzigingen.

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 migratiehandleidingen beschikbaar voor elke primaire versie.

Deze aanbevolen optie minimaliseert de inspanning die nodig is voor het migreren van AzureRM-scripts 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 heeft een compatibiliteitsmodus om u te helpen bij het gebruik van bestaande scripts terwijl u bijwerkt naar de nieuwe syntaxis. De cmdlet Enable-AzureRmAlias schakelt een compatibiliteitsmodus in via aliassen. 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 Enable-AzureRmAlias referentiedocumentatievoor 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 voor u voor de migratie zorgt. Zie de volledige lijst van breaking changes om te bepalen waar uw scripts mogelijk updates vereisen.

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

Volgende stappen