Migrer automatiquement à partir d’Azure Virtual Desktop (classique)

L’outil de module de migration vous permet de migrer automatiquement votre organization d’Azure Virtual Desktop (classique) vers Azure Virtual Desktop. Cet article vous montre comment utiliser l’outil.

Configuration requise

Avant d’utiliser le module de migration, vérifiez que les éléments suivants sont prêts :

Un abonnement Azure dans lequel vous allez créer des objets de service Azure.
Vous devez avoir le rôle Contributeur pour créer des objets Azure sur votre abonnement et le rôle Administrateur de l’accès utilisateur pour affecter des utilisateurs à des groupes d’applications.
Au moins les autorisations contributeur des services Bureau à distance (RDS) sur un locataire RDS ou les pools d’hôtes spécifiques que vous migrez.
Dernière version du module PowerShell Microsoft.RdInfra.RDPowershell.
Dernière version du module PowerShell Az.DesktopVirtualization.
Dernière version du module PowerShell Az.Resources.
Installez le module de migration sur votre ordinateur.
PowerShell ou PowerShell ISE pour exécuter les scripts que vous verrez dans cet article. Le module Microsoft.RdInfra.RDPowershell ne fonctionne pas dans PowerShell Core.

Importante

La migration crée uniquement des objets de service dans la zone géographique des États-Unis. Si vous essayez de migrer vos objets de service vers une autre zone géographique, cela ne fonctionnera pas. En outre, si vous avez plus de 500 groupes d’applications dans votre déploiement Azure Virtual Desktop (classique), vous ne pourrez pas migrer. Vous ne pourrez effectuer la migration que si vous régénérez votre environnement pour réduire le nombre de groupes d’applications au sein de votre locataire Microsoft Entra.

Préparer votre environnement PowerShell

Tout d’abord, vous devez préparer votre environnement PowerShell pour le processus de migration.

Pour préparer votre environnement PowerShell :

Avant de commencer, vérifiez que vous disposez de la dernière version des modules Az.Desktop Virtualization et Az.Resources en exécutant les applets de commande suivantes :

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

Si ce n’est pas le cas, vous devez installer et importer les modules en exécutant ces applets de commande :

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

Ensuite, désinstallez le module PowerShell RDInfra actuel en exécutant cette applet de commande :
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Ensuite, installez le module RDPowershell avec cette applet de commande :

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

Une fois que vous avez terminé d’installer tout, exécutez cette applet de commande pour vous assurer que vous disposez des versions appropriées des modules :
```
Get-Module Microsoft.RDInfra.RDPowershell
```

À présent, installons et importons le module de migration en exécutant ces applets de commande :

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

Une fois que vous avez terminé, connectez-vous à Azure Virtual Desktop (classique) dans votre fenêtre PowerShell :
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Connectez-vous à Azure Resource Manager :
```
Login-AzAccount
```
Si vous avez plusieurs abonnements, sélectionnez celui vers lequel vous souhaitez migrer vos ressources avec cette applet de commande :
```
Select-AzSubscription -Subscriptionid <subID>
```
Inscrivez le fournisseur de ressources dans Portail Azure pour l’abonnement sélectionné.
Enfin, vous devez inscrire le fournisseur. Vous pouvez procéder de deux manières :
- Si vous souhaitez utiliser PowerShell, exécutez cette applet de commande :
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Si vous préférez utiliser le Portail Azure, ouvrez et connectez-vous à l’Portail Azure, accédez à Abonnements et sélectionnez le nom de l’abonnement que vous souhaitez utiliser. Ensuite, accédez à Fournisseur de> ressourcesMicrosoft.DesktopVirtualization et sélectionnez Réinscrire. Vous ne verrez aucune modification dans l’interface utilisateur pour le moment, mais votre environnement PowerShell doit maintenant être prêt à exécuter le module.

Migrer des ressources Azure Virtual Desktop (classique) vers Azure Resource Manager

Maintenant que votre environnement PowerShell est prêt, vous pouvez commencer le processus de migration.

Pour migrer vos ressources Azure Virtual Desktop (classique) vers Azure Resource Manager :

Avant de migrer, si vous souhaitez comprendre comment les ressources classiques existantes seront mappées à de nouvelles ressources Azure Resource Manager, exécutez cette applet de commande :
```
Get-RdsHostPoolMigrationMapping
```
Avec Get-RdsHostPoolMigrationMapping, vous pouvez créer un fichier CSV qui mappe l’emplacement de vos ressources. Par exemple, si le nom de votre locataire est « Contoso » et que vous souhaitez stocker votre fichier de mappage dans le fichier « contosouser », vous devez exécuter une applet de commande qui ressemble à ceci :
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Ensuite, exécutez l’applet de commande Start-RdsHostPoolMigration pour choisir de migrer un pool d’hôtes unique ou tous les pools d’hôtes au sein d’un locataire.

Par exemple :
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Si vous souhaitez migrer vos ressources d’un pool d’hôtes spécifique, incluez le nom du pool d’hôtes. Par exemple, si vous souhaitez déplacer le pool d’hôtes nommé « Office », exécutez une commande comme suit :
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Si vous ne donnez pas de nom d’espace de travail, le module en crée automatiquement un pour vous en fonction du nom du locataire. Toutefois, si vous préférez utiliser un espace de travail spécifique, vous pouvez entrer son ID de ressource comme suit :
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Si vous souhaitez utiliser un espace de travail spécifique mais que vous ne connaissez pas son ID de ressource, exécutez cette applet de commande :
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Vous devez également spécifier un mode d’affectation d’utilisateur pour les affectations d’utilisateurs existantes :
- Utilisez Copy pour copier toutes les affectations d’utilisateurs de vos anciens groupes d’applications vers Azure Resource Manager groupes d’applications. Les utilisateurs pourront voir les flux pour les deux versions de leurs clients.
- Utilisez Aucun si vous ne souhaitez pas modifier les affectations d’utilisateurs. Par la suite, vous pouvez affecter des utilisateurs ou des groupes d’utilisateurs à des groupes d’applications avec l’Portail Azure, PowerShell ou l’API. Les utilisateurs pourront uniquement voir les flux à l’aide des clients Azure Virtual Desktop (classique).
Vous ne pouvez copier que 2 000 affectations d’utilisateurs par abonnement. Votre limite dépend donc du nombre d’affectations déjà présentes dans votre abonnement. Le module calcule la limite en fonction du nombre d’affectations que vous avez déjà. Si vous n’avez pas assez d’affectations à copier, vous recevez un message d’erreur indiquant « Quota d’attribution de rôle insuffisant pour copier les attributions d’utilisateurs. Réexécutez la commande sans le commutateur -CopyUserAssignments pour migrer. »
Une fois les commandes exécutées, la création des objets de service prend jusqu’à 15 minutes. Si vous avez copié ou déplacé des affectations d’utilisateurs, cela ajoute au temps nécessaire au module pour terminer la configuration de tout.

Une fois l’applet de commande Start-RdsHostPoolMigration terminée, vous devez voir les éléments suivants :
- Objets de service Azure pour le locataire ou le pool d’hôtes que vous avez spécifié.
- Deux nouveaux groupes de ressources :
  - Un groupe de ressources appelé « Tenantname », qui contient votre espace de travail.
  - Un groupe de ressources appelé « Tenantname_originalHostPoolName », qui contient le pool d’hôtes et les groupes d’applications de bureau.
- Tous les utilisateurs que vous avez publiés dans les groupes d’applications nouvellement créés.
- Les machines virtuelles seront disponibles dans les pools d’hôtes existants et nouveaux pour éviter les temps d’arrêt des utilisateurs pendant le processus de migration. Cela permet aux utilisateurs de se connecter à la même session utilisateur.
Étant donné que ces nouveaux objets de service Azure sont des objets Azure Resource Manager, le module ne peut pas définir des autorisations de Access Control en fonction du rôle (RBAC) ni des paramètres de diagnostic sur eux. Par conséquent, vous devez mettre à jour les autorisations et les paramètres RBAC pour ces objets manuellement.

Une fois que le module a validé les connexions utilisateur initiales, vous pouvez également publier le groupe d’applications sur plusieurs utilisateurs ou groupes d’utilisateurs, si vous le souhaitez.

Remarque

Après la migration, si vous déplacez des groupes d’applications vers un autre groupe de ressources après avoir attribué des autorisations aux utilisateurs, tous les rôles RBAC sont supprimés. Vous devez réaffecter les autorisations RBAC des utilisateurs.
Si vous souhaitez supprimer tous les objets de service Azure Virtual Desktop (classique), exécutez Complete-RdsHostPoolMigration pour terminer le processus de migration. Cette applet de commande supprime tous les objets Azure Virtual Desktop (classique), en laissant uniquement les nouveaux objets Azure. Les utilisateurs pourront uniquement voir le flux des groupes d’applications nouvellement créés sur leurs clients. Une fois cette commande terminée, vous pouvez supprimer en toute sécurité le locataire Azure Virtual Desktop (classique) pour terminer le processus.

Par exemple :
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Si vous souhaitez terminer un pool d’hôtes spécifique, vous pouvez inclure le nom du pool d’hôtes dans l’applet de commande. Par exemple, si vous souhaitez terminer un pool d’hôtes nommé « Office », vous devez utiliser une commande comme suit :
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Cela supprime tous les objets de service créés par Azure Virtual Desktop (classique). Vous n’aurez plus que les nouveaux objets Azure et les utilisateurs pourront uniquement voir le flux des groupes d’applications nouvellement créés sur leurs clients. Une fois que vous avez terminé de finaliser votre migration, vous devez supprimer explicitement le locataire dans Azure Virtual Desktop (classique).
Si vous avez changé d’avis sur la migration et souhaitez rétablir le processus, exécutez l’applet de commande Revert-RdsHostPoolMigration .

Par exemple :
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Si vous souhaitez rétablir un pool d’hôtes spécifique, vous pouvez inclure le nom du pool d’hôtes dans la commande . Par exemple, si vous souhaitez rétablir un pool d’hôtes nommé « Office », vous devez entrer quelque chose comme suit :
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Cette applet de commande supprime tous les objets de service Azure nouvellement créés. Vos utilisateurs verront uniquement le flux pour les objets Azure Virtual Desktop (classique) dans leurs clients.

Toutefois, l’applet de commande ne supprime pas l’espace de travail que le module a créé ou le groupe de ressources associé. Vous devez supprimer manuellement ces éléments pour vous en débarrasser.
Si vous ne souhaitez pas encore supprimer vos objets de service Azure Virtual Desktop (classique), mais que vous souhaitez tester la migration, vous pouvez exécuter Set-RdsHostPoolHidden.

Par exemple :
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
La définition de la status sur « true » masque les ressources Azure Virtual Desktop (classique). La définition de la valeur « false » révélera les ressources à vos utilisateurs.

Le paramètre -Hostpool est facultatif. Vous pouvez utiliser ce paramètre si vous souhaitez masquer un pool d’hôtes Azure Virtual Desktop (classique) spécifique.

Cette applet de commande masque les objets de service et de flux utilisateur Azure Virtual Desktop (classique) au lieu de les supprimer. Toutefois, cela est généralement utilisé uniquement à des fins de test et ne compte pas comme une migration terminée. Pour terminer votre migration, vous devez exécuter la commande Complete-RdsHostPoolMigration . Sinon, restaurez votre déploiement en exécutant Revert-RdsHostPoolMigration.

Résoudre les problèmes de migration automatique

Cette section explique comment résoudre les problèmes fréquemment rencontrés dans le module de migration.

Je ne parviens pas à accéder au locataire

Tout d’abord, essayez ces deux choses :

Vérifiez que votre compte administrateur dispose des autorisations requises pour accéder au locataire.
Essayez d’exécuter Get-RdsTenant sur le locataire.

Si ces deux éléments fonctionnent, essayez d’exécuter l’applet de commande Set-RdsMigrationContext pour définir le contexte RDS et le contexte ADAL pour votre migration :

Créez le contexte RDS en exécutant l’applet de commande Add-RdsAccount .
Recherchez le contexte RDS dans la variable globale $rdMgmtContext.
Recherchez le contexte ADAL dans la variable globale $AdalContext.
Exécutez Set-RdsMigrationContext avec les variables que vous avez trouvées dans ce format :
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Étapes suivantes

Si vous souhaitez apprendre à migrer votre déploiement manuellement, consultez Migrer manuellement à partir d’Azure Virtual Desktop (classique).

Une fois que vous avez migré, découvrez le fonctionnement d’Azure Virtual Desktop en consultant nos tutoriels. Découvrez les fonctionnalités de gestion avancées dans Développer un pool d’hôtes existant et Personnaliser les propriétés RDP.

Pour en savoir plus sur les objets de service, case activée environnement Azure Virtual Desktop.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-06-20