Automatisch migreren vanuit Azure Virtual Desktop (klassiek)

Met de migratiemodule 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 de volgende zaken voorbereiden:

• Een Azure-abonnement waarmee u nieuwe Azure-serviceobjecten kunt maken.

• U moet de rol Inzender toegewezen krijgen om Azure-objecten in uw abonnement te maken, en de rol Beheerder gebruikerstoegang om gebruikers toe te wijzen aan toepassingsgroepen.

• Ten minste inzendermachtigingen voor Extern bureaublad Services (RDS) voor een RDS-tenant of de specifieke hostgroepen die u gaat migreren.

• De nieuwste versie van de PowerShell-module Microsoft.RdInfra.RDPowershell.

• De nieuwste versie van de Az.DesktopVirtualization PowerShell-module.

• 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 zult zien. De module Microsoft.RdInfra.RDPowershell werkt niet in PowerShell Core.

Uw PowerShell-omgeving voorbereiden

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

Uw PowerShell-omgeving voorbereiden:

1. 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 dit niet doet, moet u de modules installeren en importeren door de volgende cmdlets uit te voeren:

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

2. Verwijder vervolgens de huidige RDInfra PowerShell-module door deze cmdlet uit te voeren:

   Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
   

3. 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
   

4. Wanneer u alles hebt geïnstalleerd, voert u deze cmdlet uit om te controleren of u de juiste versies van de modules hebt:

   Get-Module Microsoft.RDInfra.RDPowershell
   

5. Nu gaan we de migratiemodule installeren en importeren door de volgende 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
   

6. Als u klaar bent, meldt u zich aan bij Azure Virtual Desktop (klassiek) in het PowerShell-venster:

   Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
   

7. Meld u aan bij Azure Resource Manager:

   Login-AzAccount
   

8. Als u meerdere abonnementen hebt, selecteert u met deze cmdlet het abonnement waarnaar u uw resources wilt migreren:

   Select-AzSubscription -Subscriptionid <subID>
   

9. Registreer de resourceprovider in Azure Portal voor het geselecteerde abonnement.

10. 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 de Azure Portal gebruikt, opent u het Azure Portal, meldt u zich aan, 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 gereed zijn om de module uit te voeren.

Migreer Azure Virtuele bureaublad-resources (klassiek) naar Azure Resource Manager

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

Je Azure virtuele bureaublad (klassieke) resources migreren naar Azure Resource Manager:

1. Voer de volgende cmdlet uit als u wilt begrijpen hoe de bestaande klassieke resources worden toegewezen aan nieuwe Azure Resource Manager-resources:

   Get-RdsHostPoolMigrationMapping
   

   Met Get-RdsHostPoolMigrationMapping kunt u een CSV-bestand maken dat aangeeft waar uw resources naartoe gaan. 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'
   

2. Voer vervolgens de cmdlet Start-RdsHostPoolMigration uit om te kiezen of u één hostgroep of alle hostgroepen binnen een tenant wilt migreren.

   Bijvoorbeeld:

   Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
   

   Als u uw resources wilt migreren naar een specifieke hostgroep, moet u de naam van de hostgroep opnemen. 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 opgeeft, wordt er automatisch een voor u gemaakt op basis van de tenantnaam. 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 naar Azure Resource Manager toepassingsgroepen te kopiëren. Gebruikers kunnen feeds voor beide versies van hun clients bekijken.
   • Gebruik Geen als u de gebruikerstoewijzingen niet wilt wijzigen. Later kunt u gebruikers of gebruikersgroepen toewijzen aan toepassingsgroepen met behulp van de Azure Portal, PowerShell of API. Gebruikers kunnen alleen feeds bekijken met de Azure Virtual Desktop-clients (klassiek).

   U kunt per abonnement slechts 2000 gebruikerstoewijzingen kopiëren, dus uw limiet is afhankelijk van het aantal toewijzingen in uw abonnement. De module berekent de limiet op basis van het aantal opdrachten dat u al hebt. Als u niet voldoende toewijzingen hebt om te kopiëren, wordt het foutbericht 'Onvoldoende quota voor roltoewijzingen om gebruikerstoewijzingen te kopiëren. Rerun command without the -CopyUserAssignments switch to migrate '.

3. 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, duurt het langer voordat de module klaar is met het instellen van alle toewijzingen.

   Nadat de cmdlet Start-RdsHostPoolMigration is uitgevoerd, ziet u de volgende dingen:

   • Azure-serviceobjecten voor de opgegeven tenant of hostgroep.

   • Twee nieuwe resourcegroepen:

     • Een resourcegroep met de naam Tenantnaam, 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. Hierdoor kunnen gebruikers verbinding maken met dezelfde gebruikerssessie.

   Aangezien deze nieuwe Azure serviceobjecten Azure Resource Manager objecten zijn, kan de module geen machtigingen voor Access Control op basis van rollen of diagnostische instellingen instellen. Daarom moet u de machtigingen en instellingen voor RBAC voor deze objecten handmatig bijwerken.

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

   Opmerking

   Als u na de migratie toepassingsgroepen naar een andere resourcegroep verplaatst nadat u machtigingen aan gebruikers hebt toegewezen, worden alle rollen van Wisselbeheer verwijderd. U moet de RBAC-machtigingen aan gebruikers opnieuw toewijzen.

4. Als u alle (klassieke) Azure Virtual Desktop-serviceobjecten wilt verwijderen, voert u Complete-RdsHostPoolMigration uit om het migratieproces te voltooien. Met deze cmdlet worden alle klassieke objecten (klassieke) objecten van Azure Virtual Desktop verwijderd, zodat alleen de nieuwe Azure-objecten overblijven. Gebruikers kunnen de feed alleen zien voor de nieuw 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.

   Bijvoorbeeld:

   Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
   

   Als u een specifieke hostgroep wilt samenstellen, kunt u de naam van de hostgroep in de cmdlet opnemen. Als u bijvoorbeeld een hostgroep met de naam Office wilt samenstellen, gebruikt u een opdracht zoals deze:

   Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
   

   Hiermee worden alle serviceobjecten verwijderd die door Azure virtuele bureaublad (klassiek) zijn gemaakt. U houdt alleen de nieuwe Azure-objecten over en gebruikers kunnen alleen de feed voor de nieuw gemaakte toepassingsgroepen op hun clients zien. Wanneer u klaar bent met de voltooiing van de migratie, moet u de tenant expliciet verwijderen in Azure Virtual Desktop (klassiek).

5. Als u van gedachten bent veranderd over de migratie en het proces wilt herstellen, voert u de cmdlet Revert-RdsHostPoolMigration uit.

   Bijvoorbeeld:

   Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
   

   Als je een specifieke hostgroep wilt herstellen, kun je de naam van de hostgroep in de opdracht opnemen. Als u bijvoorbeeld een hostgroep met de naam Office wilt herstellen, voert u zoiets als dit in:

   Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
   

   Met deze cmdlet worden alle nieuw gemaakte Azure serviceobjecten verwijderd. Uw gebruikers zien alleen de feed voor Azure klassieke objecten (klassiek) van Virtueel bureaublad in hun clients.

   Met de cmdlet wordt echter niet de werkruimte verwijderd die de module heeft gemaakt of de bijbehorende resourcegroep. U moet deze items handmatig verwijderen om ze te verwijderen.

6. Als u de (klassieke) Azure Virtual Desktop-serviceobjecten nog niet wilt verwijderen, maar de migratie wel wilt testen, kunt u Set-RdsHostPoolHidden uitvoeren.

   Bijvoorbeeld:

   Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
   

   Als u de status instelt op 'true', worden de resources van de klassieke versie van Azure Virtual Desktop verborgen. Als u de optie instelt op 'onwaar', worden de resources aan uw gebruikers weergegeven.

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

   Met deze cmdlet worden de Azure Virtual Desktop-gebruikersfeed (klassiek) en serviceobjecten verborgen in plaats van verwijderd. Dit wordt echter meestal alleen gebruikt voor testdoeleinden en telt niet mee als een voltooide migratie. Als u de migratie wilt voltooien, moet u de opdracht Complete-RdsHostPoolMigration uitvoeren. Herstel anders de implementatie 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 deze twee dingen:

• Zorg ervoor dat uw beheerdersaccount over de vereiste toegangsmachtigingen voor de tenant beschikt.
• Probeer Get-RdsTenant uit te voeren op de tenant.

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

1. Maak de RDS-context door de cmdlet Add-RdsAccount uit te voeren.

2. Zoek de RDS-context in de globale variabele $rdMgmtContext.

3. Zoek de ADAL-context in de globale variabele $AdalContext.

4. Voer Set-RdsMigrationContext uit met de variabelen die u in deze notatie hebt gevonden:

   Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
   

Volgende stappen

Als u wilt weten hoe u uw implementatie handmatig migreert, raadpleegt u Handmatig migreren vanuit Azure Virtual Desktop (klassiek).

Na de migratie kunt u zien hoe Azure Virtual Desktop werkt door onze zelfstudies te bekijken. Meer informatie over geavanceerde beheermogelijkheden vindt u in Een bestaande hostgroep uitbreiden en RDP-eigenschappen aanpassen.

Ga naar Azure Virtual Desktop-omgeving voor meer informatie over serviceobjecten.