Automatisch migreren vanuit Azure Virtual Desktop (klassiek)

Artikel
10/18/2023

Met het hulpprogramma voor migratiemodules kunt u uw organisatie automatisch migreren van Azure Virtual Desktop (klassiek) naar Azure Virtual Desktop. In dit artikel wordt uitgelegd hoe u het hulpprogramma gebruikt.

Vereisten

Voordat u de migratiemodule gebruikt, moet u ervoor zorgen dat u over de volgende zaken beschikt:

Een Azure-abonnement waarin u nieuwe Azure-serviceobjecten maakt.
U moet de rol Inzender hebben toegewezen om Azure-objecten in uw abonnement te maken en de rol Gebruikerstoegang Beheer istrator om gebruikers toe te wijzen aan toepassingsgroepen.
Ten minste rdS-machtigingen (Remote Desktop Services) inzender voor een RDS-tenant of de specifieke hostgroepen die u migreert.
De nieuwste versie van de PowerShell-module Microsoft.RdInfra.RDPowershell.
De nieuwste versie van de PowerShell-module Az.DesktopVirtualization.
De nieuwste versie van de Az.Resources PowerShell-module.
Installeer de migratiemodule op uw computer.
PowerShell of PowerShell ISE om de scripts uit te voeren die u in dit artikel ziet. De Microsoft.RdInfra.RDPowershell-module werkt niet in PowerShell Core.

Belangrijk

Migratie maakt alleen serviceobjecten in de geografie van de VS. Als u uw serviceobjecten probeert te migreren naar een andere geografie, werkt dit niet. Als u meer dan 500 toepassingsgroepen hebt in uw Implementatie van Azure Virtual Desktop (klassiek), kunt u niet migreren. U kunt alleen migreren als u uw omgeving opnieuw bouwt om het aantal toepassingsgroepen in uw Microsoft Entra-tenant te verminderen.

Uw PowerShell-omgeving voorbereiden

Eerst moet u uw PowerShell-omgeving voorbereiden voor het migratieproces.

Uw PowerShell-omgeving voorbereiden:

Voordat u begint, moet u ervoor zorgen dat u de nieuwste versie van de modules Az.Desktop Virtualization en Az.Resources hebt door de volgende cmdlets uit te voeren:

Get-Module Az.Resources
Get-Module Az.DesktopVirtualization
https://www.powershellgallery.com/packages/Az.DesktopVirtualization/
https://www.powershellgallery.com/packages/Az.Resources/

Als u dat niet doet, moet u de modules installeren en importeren door deze cmdlets uit te voeren:

Install-module Az.Resources
Import-module Az.Resources
Install-module Az.DesktopVirtualization
Import-module Az.DesktopVirtualization

Verwijder vervolgens de huidige RDInfra PowerShell-module door deze cmdlet uit te voeren:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Installeer daarna de RDPowerShell-module met deze cmdlet:

Install-Module -Name Microsoft.RDInfra.RDPowershell -RequiredVersion 1.0.3414.0 -force
Import-module Microsoft.RDInfra.RDPowershell

Wanneer u klaar bent met het installeren van alles, voert u deze cmdlet uit om te controleren of u de juiste versies van de modules hebt:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Nu gaan we de migratiemodule installeren en importeren door deze cmdlets uit te voeren:

Install-Module -Name PackageManagement -Repository PSGallery -Force
Install-Module -Name PowerShellGet -Repository PSGallery -Force
# Then restart shell
Install-Module -Name Microsoft.RdInfra.RDPowershell.Migration -AllowClobber
Import-Module <Full path to the location of the migration module>\Microsoft.RdInfra.RDPowershell.Migration.psd1

Zodra u klaar bent, meldt u zich aan bij Azure Virtual Desktop (klassiek) in uw PowerShell-venster:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Meld u aan bij Azure Resource Manager:
```
Login-AzAccount
```
Als u meerdere abonnementen hebt, selecteert u het abonnement waarnaar u uw resources wilt migreren met deze cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registreer de resourceprovider in Azure Portal voor het geselecteerde abonnement.
Ten slotte moet u de provider registreren. U kunt dit op twee manieren doen:
- Als u PowerShell wilt gebruiken, voert u deze cmdlet uit:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Als u liever Azure Portal gebruikt, opent en meldt u zich aan bij Azure Portal, gaat u naar Abonnementen en selecteert u de naam van het abonnement dat u wilt gebruiken. Ga daarna naar Resource Provider>Microsoft.DesktopVirtualization en selecteer Opnieuw registreren. U ziet nog niets in de gebruikersinterface, maar uw PowerShell-omgeving moet nu klaar zijn om de module uit te voeren.

Azure Virtual Desktop-resources (klassiek) migreren naar Azure Resource Manager

Nu uw PowerShell-omgeving gereed is, kunt u het migratieproces starten.

Uw Azure Virtual Desktop-resources (klassiek) migreren naar Azure Resource Manager:

Voordat u migreert, moet u deze cmdlet uitvoeren als u wilt weten hoe de bestaande klassieke resources worden toegewezen aan nieuwe Azure Resource Manager-resources:
```
Get-RdsHostPoolMigrationMapping
```
Met Get-RdsHostPoolMigrationMapping kunt u een CSV-bestand maken waarin de locatie van uw resources wordt toegewezen. Als de naam van uw tenant bijvoorbeeld Contoso is en u het toewijzingsbestand wilt opslaan in het bestand contosouser, voert u een cmdlet uit die er als volgt uitziet:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Voer vervolgens de cmdlet Start-RdsHostPoolMigration uit om te kiezen of u één hostgroep of alle hostgroepen binnen een tenant wilt migreren.

Voorbeeld:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Als u uw resources een specifieke hostgroep wilt migreren, neemt u de naam van de hostgroep op. Als u bijvoorbeeld de hostgroep met de naam Office wilt verplaatsen, voert u een opdracht als volgt uit:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Als u geen werkruimtenaam geeft, wordt er automatisch een voor u gemaakt op basis van de naam van de tenant. Als u echter liever een specifieke werkruimte gebruikt, kunt u de resource-id als volgt invoeren:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Als u een specifieke werkruimte wilt gebruiken, maar de resource-id niet weet, voert u deze cmdlet uit:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
U moet ook een gebruikerstoewijzingsmodus opgeven voor de bestaande gebruikerstoewijzingen:
- Gebruik Kopiëren om alle gebruikerstoewijzingen van uw oude toepassingsgroepen te kopiëren naar Azure Resource Manager-toepassingsgroepen. Gebruikers kunnen feeds zien voor beide versies van hun clients.
- Gebruik Geen als u de gebruikerstoewijzingen niet wilt wijzigen. Later kunt u gebruikers of gebruikersgroepen toewijzen aan toepassingsgroepen met de Azure-portal, PowerShell of API. Gebruikers kunnen alleen feeds zien met behulp van de Azure Virtual Desktop-clients (klassiek).
U kunt slechts 2000 gebruikerstoewijzingen per abonnement kopiëren, zodat uw limiet afhankelijk is van het aantal toewijzingen dat al in uw abonnement staat. De module berekent de limiet op basis van het aantal toewijzingen dat u al hebt. Als u onvoldoende toewijzingen hebt om te kopiëren, krijgt u een foutbericht met de tekst 'Onvoldoende quotum voor roltoewijzing voor het kopiëren van gebruikerstoewijzingen. Voer de opdracht opnieuw uit zonder de schakeloptie -CopyUserAssignments om te migreren.
Nadat u de opdrachten hebt uitgevoerd, duurt het maximaal 15 minuten voordat de module de serviceobjecten heeft gemaakt. Als u gebruikerstoewijzingen hebt gekopieerd of verplaatst, wordt deze toegevoegd aan de tijd die nodig is voordat de module klaar is met het instellen van alles.

Nadat de cmdlet Start-RdsHostPoolMigration is voltooid, ziet u het volgende:
- Azure-serviceobjecten voor de tenant of hostgroep die u hebt opgegeven.
- Twee nieuwe resourcegroepen:
  - Een resourcegroep met de naam Tenantname, die uw werkruimte bevat.
  - Een resourcegroep met de naam 'Tenantname_originalHostPoolName', die de hostgroep en bureaubladtoepassingsgroepen bevat.
- Alle gebruikers die u hebt gepubliceerd naar de zojuist gemaakte toepassingsgroepen.
- Virtuele machines zijn beschikbaar in zowel bestaande als nieuwe hostgroepen om downtime van gebruikers tijdens het migratieproces te voorkomen. Hiermee kunnen gebruikers verbinding maken met dezelfde gebruikerssessie.
Omdat deze nieuwe Azure-serviceobjecten Azure Resource Manager-objecten zijn, kan de module geen RBAC-machtigingen (Op rollen gebaseerd toegangsbeheer) of diagnostische instellingen instellen. Daarom moet u de RBAC-machtigingen en -instellingen voor deze objecten handmatig bijwerken.

Zodra de module de initiële gebruikersverbindingen valideert, kunt u de toepassingsgroep desgewenst ook publiceren naar meer gebruikers of gebruikersgroepen.

Notitie

Als u na de migratie toepassingsgroepen naar een andere resourcegroep verplaatst nadat u machtigingen aan gebruikers hebt toegewezen, worden alle RBAC-rollen verwijderd. U moet gebruikers RBAC-machtigingen opnieuw toewijzen.
Als u alle serviceobjecten van Azure Virtual Desktop (klassiek) wilt verwijderen, voert u Complete RdsHostPoolMigration uit om het migratieproces te voltooien. Met deze cmdlet worden alle Azure Virtual Desktop-objecten (klassiek) verwijderd, waardoor alleen de nieuwe Azure-objecten behouden blijven. Gebruikers kunnen de feed alleen zien voor de zojuist gemaakte toepassingsgroepen op hun clients. Zodra deze opdracht is voltooid, kunt u de Azure Virtual Desktop-tenant (klassiek) veilig verwijderen om het proces te voltooien.

Voorbeeld:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Als u een specifieke hostgroep wilt voltooien, kunt u de naam van de hostgroep opnemen in de cmdlet. Als u bijvoorbeeld een hostgroep met de naam Office wilt voltooien, gebruikt u een opdracht als volgt:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Hiermee worden alle serviceobjecten verwijderd die zijn gemaakt door Azure Virtual Desktop (klassiek). U blijft over met alleen de nieuwe Azure-objecten en gebruikers kunnen de feed alleen zien voor de zojuist gemaakte toepassingsgroepen op hun clients. Zodra u klaar bent met het voltooien van de migratie, moet u de tenant expliciet verwijderen in Azure Virtual Desktop (klassiek).
Als u van gedachten bent veranderd over het migreren en het proces wilt herstellen, voert u de cmdlet Revert-RdsHostPoolMigration uit.

Voorbeeld:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Als u een specifieke hostgroep wilt terugzetten, kunt u de naam van de hostgroep opnemen in de opdracht. Als u bijvoorbeeld een hostgroep met de naam 'Office' wilt terugzetten, voert u zoiets in:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Met deze cmdlet worden alle zojuist gemaakte Azure-serviceobjecten verwijderd. Uw gebruikers zien alleen de feed voor Azure Virtual Desktop-objecten (klassiek) in hun clients.

De cmdlet verwijdert echter niet de werkruimte die de module heeft gemaakt of de bijbehorende resourcegroep. U moet deze items handmatig verwijderen om ze te verwijderen.
Als u uw Azure Virtual Desktop-serviceobjecten (klassiek) nog niet wilt verwijderen, maar wel migratie wilt testen, kunt u Set-RdsHostPoolHidden uitvoeren.

Voorbeeld:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Als u de status instelt op 'true', worden de Azure Virtual Desktop-resources (klassiek) verborgen. Als u deze instelt op 'false', worden de resources aan uw gebruikers weergegeven.

De parameter -Hostpool is optioneel. U kunt deze parameter gebruiken als er een specifieke Azure Virtual Desktop-hostgroep (klassiek) is die u wilt verbergen.

Met deze cmdlet worden de gebruikersfeeds en serviceobjecten van Azure Virtual Desktop (klassiek) verborgen in plaats van ze te verwijderen. Dit wordt echter meestal alleen gebruikt voor testen en telt niet als een voltooide migratie. Als u de migratie wilt voltooien, moet u de opdracht Complete-RdsHostPoolMigration uitvoeren. Anders kunt u de implementatie ongedaan maken door Revert-RdsHostPoolMigration uit te voeren.

Problemen met automatische migratie oplossen

In deze sectie wordt uitgelegd hoe u veelvoorkomende problemen in de migratiemodule kunt oplossen.

Ik heb geen toegang tot de tenant

Probeer eerst de volgende twee dingen:

Zorg ervoor dat uw beheerdersaccount over de vereiste machtigingen beschikt om toegang te krijgen tot de tenant.
Probeer Get-RdsTenant uit te voeren op de tenant.

Als deze twee dingen werken, voert u de cmdlet Set-RdsMigrationContext uit om de RDS-context en de ADAL-context voor uw migratie in te stellen:

Maak de RDS-context door de cmdlet Add-RdsAccount uit te voeren.
Zoek de RDS-context in de globale variabele $rdMgmtContext.
Zoek de ADAL-context in de globale variabele $AdalContext.
Voer Set-RdsMigrationContext uit met de variabelen die u in deze indeling hebt gevonden:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Volgende stappen

Zie Migreren handmatig vanuit Azure Virtual Desktop (klassiek) als u wilt weten hoe u uw implementatie handmatig migreert.

Zodra u bent gemigreerd, leert u hoe Azure Virtual Desktop werkt door onze zelfstudies te bekijken. Meer informatie over geavanceerde beheermogelijkheden bij Een bestaande hostgroep uitbreiden en RDP-eigenschappen aanpassen.

Raadpleeg de Azure Virtual Desktop-omgeving voor meer informatie over serviceobjecten.

Delen via