Een virtueel Azure-netwerk migreren van klassiek naar Resource Manager met behulp van Azure PowerShell

Artikel
10/18/2023

In dit artikel leert u hoe u migreert van het klassieke implementatiemodel naar het nieuwere Resource Manager-implementatiemodel.

Migratie van klassiek naar Resource Manager is één virtueel netwerk tegelijk voltooid. Er is geen extra vereiste voor hulpprogramma's of vereisten voor migratie, behalve de Azure PowerShell-vereisten. De migratie is een besturingsvlakmigratie van virtuele netwerkresources. Er is geen downtime van het gegevenspad tijdens de migratie. Bestaande workloads blijven functioneren zonder verlies van connectiviteit tijdens de migratie. Openbare IP-adressen die zijn gekoppeld aan het virtuele netwerk, worden niet gewijzigd tijdens het migratieproces.

Wanneer de migratie is voltooid, moeten alle beheerbewerkingen worden uitgevoerd met behulp van het Resource Manager-model. Beheerbewerkingen zijn alleen toegankelijk via het Resource Manager-implementatiemodel. Wijzigingen in subnetten of virtuele netwerken zijn niet meer beschikbaar via het oude implementatiemodel.

Wanneer u het virtuele netwerk migreert van het klassieke naar het Resource Manager-model, worden de ondersteunde resources binnen het virtuele netwerk automatisch gemigreerd naar het nieuwe model.

Vereisten

Een Azure-account met een actief abonnement. Maak gratis een account.
In de stappen en voorbeelden in dit artikel wordt de Az-module van Azure PowerShell gebruikt. Zie Azure PowerShell installeren als u de Az-modules lokaal op uw computer wilt installeren. Zie Introductie van de nieuwe Az-module van Azure PowerShell voor meer informatie over de Az-module. PowerShell-cmdlets worden regelmatig bijgewerkt. Als u de meest recente versie niet uitvoert, kunnen de waarden die in de instructies zijn opgegeven, mislukken. Gebruik de cmdlet Get-Module -ListAvailable Az cmdlet om de geïnstalleerde versies van PowerShell op uw systeem te vinden.
Als u een virtueel netwerk met een toepassingsgateway wilt migreren, verwijdert u de gateway voordat u een voorbereidingsbewerking uitvoert om het netwerk te verplaatsen. Nadat u de migratie hebt voltooid, maakt u opnieuw verbinding met de gateway in Azure Resource Manager.
Controleer of u zowel de klassieke als de Az Azure PowerShell-modules lokaal op uw computer hebt geïnstalleerd. Zie Azure PowerShell installeren en configureren voor meer informatie.
Azure ExpressRoute-gateways die verbinding maken met ExpressRoute-circuits in een ander abonnement, kunnen niet automatisch worden gemigreerd. In deze gevallen verwijdert u de ExpressRoute-gateway, migreert u het virtuele netwerk en maakt u de gateway opnieuw.

Ondersteunde scenario's

De volgende scenario's worden ondersteund voor een klassieke naar Resource Manager-migratie:

Klassieke virtuele netwerken met virtuele machines.
Klassieke virtuele netwerken met maximaal één beschikbaarheidsset per cloudservice.
Klassieke virtuele netwerken die Microsoft Entra Domain Services bevatten.
Klassieke virtuele netwerken met één VPN-gateway of één Express Route-circuit.

Niet-ondersteunde scenario's

De volgende scenario's worden niet ondersteund voor migratie:

De levenscyclus van een virtueel netwerk beheren vanuit het klassieke implementatiemodel.
Ondersteuning voor op rollen gebaseerd toegangsbeheer van Azure voor het klassieke implementatiemodel.
Migratie van virtuele netwerken met zowel ExpressRoute-gateway als VPN-gateway.
Migratie van virtuele netwerken met meer dan één beschikbaarheidsset in één cloudservice.
Migratie van virtuele netwerken met een of meer beschikbaarheidssets en virtuele machines die zich niet in een beschikbaarheidsset in één cloudservice bevinden.
Migratie van toepassingsgateway van klassiek naar Resource Manager.

Resourceprovider registreren

In deze sectie meldt u zich aan bij uw abonnement met behulp van de Resource Manager-cmdlets en registreert u de migratieresourceprovider.

Meld u aan bij Azure PowerShell:
```
Connect-AzAccount
```
Registreer de migratieresourceprovider:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
Wacht vijf minuten totdat de registratie is voltooid. Controleer de status van de registratie met behulp van de volgende opdracht:
```
Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate
```
Zorg ervoor dat RegistrationState zich bevindt Registered voordat u verdergaat.

Notitie

Registratie is een eenmalige stap, maar u moet dit eenmaal doen voordat u de migratie uitvoert. Als u zich niet registreert, ziet u het volgende foutbericht:

BadRequest: Abonnement is niet geregistreerd voor migratie.

De naam van het virtuele netwerk ophalen die moet worden gemigreerd

In deze sectie meldt u zich aan bij het klassieke implementatiemodel PowerShell en haalt u de naam op van het virtuele netwerk dat moet worden gemigreerd.

Meld u aan bij de klassieke implementatie van PowerShell:
```
Add-AzureAccount
```
Voer de volgende opdracht uit om de naam van het klassieke virtuele netwerk op te halen:
```
Get-AzureVnetSite | Select -Property Name
```

Noteer de naam van het virtuele netwerk voor de volgende sectie.

Het virtuele netwerk migreren

In deze sectie valideert u of de migratie kan worden voortgezet en vervolgens de migratie kan voorbereiden.

Plaats de naam van het virtuele netwerk dat u in de vorige sectie hebt genoteerd in een variabele voor gebruik door de opdrachten. Vervang myVNet door de naam van het virtuele netwerk dat u in de vorige sectie hebt opgehaald:
```
$vnetname = "myVNet"
```
Valideer dat u het virtuele netwerk kunt migreren door de volgende opdracht uit te voeren:
```
Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName
```
Met de opdracht worden eventuele waarschuwingen of fouten weergegeven die de migratie blokkeren. Als de validatie is geslaagd, kunt u doorgaan met de volgende voorbereidingsstap.

Notitie

Als het virtuele netwerk web- of werkrollen of virtuele machines met niet-ondersteunde configuraties bevat, wordt er een validatiefout weergegeven.
Voer de volgende opdracht uit om het virtuele netwerk voor te bereiden op migratie:
```
Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName
```
Als u nog niet klaar bent voor migratie en u wilt teruggaan naar de oude status, gebruikt u de volgende opdracht:
```
Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName
```

De migratie doorvoeren

Als alles er goed uitziet in de voorbereide configuratie, kunt u de migratie doorvoeren door de volgende opdracht uit te voeren:

Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Volgende stappen

Zie voor meer informatie over het migreren van resources in Azure van klassiek naar Resource Manager:

Delen via