Créer un pool d’hôtes Windows Virtual Desktop avec PowerShellCreate a Windows Virtual Desktop host pool with PowerShell

Importante

Ce contenu s’applique à Windows Virtual Desktop avec des objets Windows Virtual Desktop Azure Resource Manager.This content applies to Windows Virtual Desktop with Azure Resource Manager Windows Virtual Desktop objects. Si vous utilisez la version Windows Virtual Desktop (classique) sans objets Azure Resource Manager, consultez cet article.If you're using Windows Virtual Desktop (classic) without Azure Resource Manager objects, see this article.

Les pools d'hôtes sont des ensembles d'une ou de plusieurs machines virtuelles identiques dans des environnements de locataires Windows Virtual Desktop.Host pools are a collection of one or more identical virtual machines within Windows Virtual Desktop tenant environments. Chaque pool d’hôtes peut être associé à plusieurs groupes RemoteApp, à un groupe d’applications de bureau et à plusieurs hôtes de session.Each host pool can be associated with multiple RemoteApp groups, one desktop app group, and multiple session hosts.

PrérequisPrerequisites

Cet article suppose que vous avez déjà suivi les instructions indiquées dans Configurer le module PowerShell.This article assumes you've already followed the instructions in Set up the PowerShell module.

Utilisez votre client PowerShell pour créer un pool d’hôtesUse your PowerShell client to create a host pool

Exécutez l’applet de commande suivante pour vous connecter à l’environnement Windows Virtual Desktop :Run the following cmdlet to sign in to the Windows Virtual Desktop environment:

New-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -WorkspaceName <workspacename> -HostPoolType <Pooled|Personal> -LoadBalancerType <BreadthFirst|DepthFirst|Persistent> -Location <region> -DesktopAppGroupName <appgroupname>

Cette applet de commande crée le pool d’hôtes, l’espace de travail et le groupe d’applications de bureau.This cmdlet will create the host pool, workspace and desktop app group. En outre, elle inscrit le groupe d’applications de bureau dans l’espace de travail.Additionally, it will register the desktop app group to the workspace. Vous pouvez créer un espace de travail avec cette cmdlet ou utiliser un espace de travail existant.You can either create a workspace with this cmdlet or use an existing workspace.

Exécutez la cmdlet suivante pour créer un jeton d’inscription et permettre à un hôte de session de rejoindre le pool d'hôtes et de le sauvegarder dans un nouveau fichier sur votre ordinateur local.Run the next cmdlet to create a registration token to authorize a session host to join the host pool and save it to a new file on your local computer. Vous pouvez spécifier la durée de validité du jeton d’inscription à l'aide du paramètre -ExpirationHours.You can specify how long the registration token is valid by using the -ExpirationHours parameter.

Nota

La date d’expiration du jeton ne peut pas être antérieure à une heure ni postérieure à un mois.The token's expiration date can be no less than an hour and no more than one month. Si vous définissez -ExpirationTime en dehors de cette plage, l’applet de commande ne crée pas le jeton.If you set -ExpirationTime outside of that limit, the cmdlet won't create the token.

New-AzWvdRegistrationInfo -ResourceGroupName <resourcegroupname> -HostPoolName <hostpoolname> -ExpirationTime $((get-date).ToUniversalTime().AddDays(1).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ'))

Par exemple, si vous souhaitez créer un jeton qui expire dans deux heures, exécutez cette applet de commande :For example, if you want to create a token that expires in two hours, run this cmdlet:

New-AzWvdRegistrationInfo -ResourceGroupName <resourcegroupname> -HostPoolName <hostpoolname> -ExpirationTime $((get-date).ToUniversalTime().AddHours(2).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ'))

Exécutez la commande suivante pour ajouter des utilisateurs Azure Active Directory au groupe d’applications de bureau par défaut du pool d’hôtes.After that, run this cmdlet to add Azure Active Directory users to the default desktop app group for the host pool.

New-AzRoleAssignment -SignInName <userupn> -RoleDefinitionName "Desktop Virtualization User" -ResourceName <hostpoolname+"-DAG"> -ResourceGroupName <resourcegroupname> -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

Exécutez la commande suivante pour ajouter des utilisateurs Azure Active Directory au groupe d’applications de bureau par défaut du pool d’hôtes :Run this next cmdlet to add Azure Active Directory user groups to the default desktop app group for the host pool:

New-AzRoleAssignment -ObjectId <usergroupobjectid> -RoleDefinitionName "Desktop Virtualization User" -ResourceName <hostpoolname+"-DAG"> -ResourceGroupName <resourcegroupname> -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

Exécutez la cmdlet suivante pour exporter le jeton d’inscription vers une variable, que vous utiliserez ultérieurement dans Inscrire les machines virtuelles dans le pool d'hôtes Windows Virtual Desktop.Run the following cmdlet to export the registration token to a variable, which you will use later in Register the virtual machines to the Windows Virtual Desktop host pool.

$token = Get-AzWvdRegistrationInfo -ResourceGroupName <resourcegroupname> -HostPoolName <hostpoolname>

Créer les machines virtuelles pour le pool d'hôtesCreate virtual machines for the host pool

Vous pouvez maintenant créer une machine virtuelle Azure à joindre à votre pool d’hôtes Windows Virtual Desktop.Now you can create an Azure virtual machine that can be joined to your Windows Virtual Desktop host pool.

Vous pouvez créer une machine virtuelle de plusieurs façons :You can create a virtual machine in multiple ways:

Nota

Si vous déployez une machine virtuelle à l’aide de Windows 7 en tant que système d’exploitation hôte, le processus de création et de déploiement sera un peu différent.If you're deploying a virtual machine using Windows 7 as the host OS, the creation and deployment process will be a little different. Pour plus d'informations, consultez Déployer une machine virtuelle Windows 7 sur Windows Virtual Desktop.For more details, see Deploy a Windows 7 virtual machine on Windows Virtual Desktop.

Une fois que vous avez créé vos machines virtuelles hôtes de session, appliquez une licence Windows à une machine virtuelle hôte de session pour exécuter vos machines virtuelles Windows ou Windows Server sans payer une autre licence.After you've created your session host virtual machines, apply a Windows license to a session host VM to run your Windows or Windows Server virtual machines without paying for another license.

Préparer les machines virtuelles pour l'installation des agents Windows Virtual DesktopPrepare the virtual machines for Windows Virtual Desktop agent installations

Avant d'installer les agents Windows Virtual Desktop et d'inscrire les machines virtuelles dans votre pool d’hôtes Windows Virtual Desktop, les opérations suivantes sont requises :You need to do the following things to prepare your virtual machines before you can install the Windows Virtual Desktop agents and register the virtual machines to your Windows Virtual Desktop host pool:

  • Vous devez joindre le domaine à la machine.You must domain-join the machine. Ainsi, le compte Azure Active Directory des utilisateurs Windows Virtual Desktop entrants est mappé à leur compte Active Directory pour leur permettre d'accéder à la machine virtuelle.This allows incoming Windows Virtual Desktop users to be mapped from their Azure Active Directory account to their Active Directory account and be successfully allowed access to the virtual machine.
  • Vous devez installer le rôle Hôte de session Bureau à distance (RDSH) si la machine virtuelle exécute un système d’exploitation Windows Server.You must install the Remote Desktop Session Host (RDSH) role if the virtual machine is running a Windows Server OS. Le rôle RDSH permet la bonne installation des agents Windows Virtual Desktop.The RDSH role allows the Windows Virtual Desktop agents to install properly.

À des fins de jonction de domaine, procédez comme suit sur chaque machine virtuelle :To successfully domain-join, do the following things on each virtual machine:

  1. Connectez-vous à la machine virtuelle avec les informations d’identification que vous avez indiquées lors de la création de la machine virtuelle.Connect to the virtual machine with the credentials you provided when creating the virtual machine.

  2. Sur la machine virtuelle, lancez le Panneau de configuration et sélectionnez Système.On the virtual machine, launch Control Panel and select System.

  3. Sélectionnez successivement Nom de l’ordinateur, Modifier les paramètres et Modifier…Select Computer name, select Change settings, and then select Change…

  4. Sélectionnez Domaine, puis entrez le domaine Active Directory sur le réseau virtuel.Select Domain and then enter the Active Directory domain on the virtual network.

  5. Authentifiez-vous avec un compte de domaine qui dispose de privilèges d’accès sur les machines de jonction de domaine.Authenticate with a domain account that has privileges to domain-join machines.

    Nota

    Si vous joignez vos machines virtuelles à un environnement Azure Active Directory Domain Services (Azure AD DS), vérifiez que votre utilisateur de jonction de domaine est également membre du groupe Administrateurs AAD DC.If you're joining your VMs to an Azure Active Directory Domain Services (Azure AD DS) environment, ensure that your domain join user is also a member of the AAD DC Administrators group.

Importante

Nous vous recommandons de ne pas activer de stratégies ou de configurations qui désactivant Windows Installer.We recommend that you don't enable any policies or configurations that disable Windows Installer. Si vous désactivez Windows Installer, le service ne pourra pas installer les mises à jour de l'agent sur vos hôtes de session, et ces derniers ne fonctionneront pas correctement.If you disable Windows Installer, the service won't be able to install agent updates on your session hosts, and your session hosts won't function properly.

Inscrire les machines virtuelles dans le pool d'hôtes Windows Virtual DesktopRegister the virtual machines to the Windows Virtual Desktop host pool

L'inscription des machines virtuelles dans un pool d’hôtes Windows Virtual Desktop est aussi simple que l'installation des agents Windows Virtual Desktop.Registering the virtual machines to a Windows Virtual Desktop host pool is as simple as installing the Windows Virtual Desktop agents.

Pour inscrire les agents Windows Virtual Desktop, procédez comme suit sur chaque machine virtuelle :To register the Windows Virtual Desktop agents, do the following on each virtual machine:

  1. Connectez-vous à la machine virtuelle avec les informations d’identification que vous avez indiquées lors de la création de la machine virtuelle.Connect to the virtual machine with the credentials you provided when creating the virtual machine.
  2. Téléchargez et installez l'agent Windows Virtual Desktop.Download and install the Windows Virtual Desktop Agent.
    • Téléchargez l'agent Windows Virtual Desktop.Download the Windows Virtual Desktop Agent.
    • Exécutez le programme d’installation.Run the installer. Lorsque le programme d’installation vous demande le jeton d’inscription, entrez la valeur obtenue à partir de la cmdlet Get-AzWvdRegistrationInfo.When the installer asks you for the registration token, enter the value you got from the Get-AzWvdRegistrationInfo cmdlet.
  3. Téléchargez et installez le chargeur de démarrage de l'agent Windows Virtual Desktop.Download and install the Windows Virtual Desktop Agent Bootloader.

Importante

Pour contribuer à sécuriser votre environnement Windows Virtual Desktop dans Azure, nous vous recommandons de ne pas ouvrir le port entrant 3389 sur vos machines virtuelles.To help secure your Windows Virtual Desktop environment in Azure, we recommend you don't open inbound port 3389 on your VMs. Windows Virtual Desktop ne nécessite pas l’ouverture du port entrant 3389 pour permettre aux utilisateurs d’accéder aux machines virtuelles du pool hôte.Windows Virtual Desktop doesn't require an open inbound port 3389 for users to access the host pool's VMs. Si vous devez ouvrir le port 3389 pour résoudre des problèmes, nous vous recommandons d’utiliser un accès à la machine virtuelle juste-à-temps.If you must open port 3389 for troubleshooting purposes, we recommend you use just-in-time VM access. Nous vous recommandons également de ne pas attribuer vos machines virtuelles à une adresse IP publique.We also recommend you don't assign your VMs to a public IP.

Mettre à jour l’agentUpdate the agent

Vous devrez mettre à jour l’agent si vous vous trouvez dans l’une des situations suivantes :You'll need to update the agent if you're in one of the following situations:

  • Vous souhaitez migrer un hôte de session précédemment inscrit vers un nouveau pool d’hôtes.You want to migrate a previously registered session host to a new host pool
  • L’hôte de la session n’apparaît pas dans votre pool d’hôtes après une mise à jour.The session host doesn't appear in your host pool after an update

Pour mettre à jour l’agent :To update the agent:

  1. Connectez-vous à la machine virtuelle en tant qu’administrateur.Sign in to the VM as an administrator.

  2. Accédez à Services, puis arrêtez les processus Rdagent et Chargeur d’agent Bureau à distance.Go to Services, then stop the Rdagent and Remote Desktop Agent Loader processes.

  3. Ensuite, recherchez les MSI de l’agent et du chargeur de démarrage.Next, find the agent and bootloader MSIs. Ils se trouvent soit dans le dossier C:\DeployAgent, soit dans l’emplacement où vous les avez enregistrés lors de l’installation.They'll either be located in the C:\DeployAgent folder or whichever location you saved it to when you installed it.

  4. Recherchez les fichiers suivants et désinstallez-les :Find the following files and uninstall them:

    • Microsoft.RDInfra.RDAgent.Installer-x64-verx.x.xMicrosoft.RDInfra.RDAgent.Installer-x64-verx.x.x
    • Microsoft.RDInfra.RDAgentBootLoader.Installer-x64Microsoft.RDInfra.RDAgentBootLoader.Installer-x64

    Pour désinstaller ces fichiers, cliquez avec le bouton droit sur chaque nom de fichier, puis sélectionnez Désinstaller.To uninstall these files, right-click on each file name, then select Uninstall.

  5. Si vous le souhaitez, vous pouvez également supprimer les paramètres de registre suivants :Optionally, you can also remove the following registry settings:

    • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgentComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent
    • Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDAgentBootLoaderComputer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDAgentBootLoader
  6. Une fois que vous avez désinstallé ces éléments, vous devez supprimer toutes les associations avec l’ancien pool d’hôtes.Once you've uninstalled these items, this should remove all associations with the old host pool. Si vous souhaitez réinscrire cet hôte auprès du service, suivez les instructions figurant dans Inscrire les machines virtuelles dans le pool d'hôtes Windows Virtual Desktop.If you want to reregister this host to the service, follow the instructions in Register the virtual machines to the Windows Virtual Desktop host pool.

Étapes suivantesNext steps

Après avoir créé un pool d'hôtes, vous pouvez le remplir avec RemoteApps.Now that you've made a host pool, you can populate it with RemoteApps. Pour en savoir plus sur la façon de gérer des applications dans Windows Virtual Desktop, consultez le tutoriel Gérer les groupes d’applications.To learn more about how to manage apps in Windows Virtual Desktop, see the Manage app groups tutorial.