Personnaliser les propriétés de Remote Desktop Protocol (RDP) pour un pool d’hôtes
Important
Ce contenu s’applique à Azure Virtual Desktop avec des objets Azure Virtual Desktop pour Azure Resource Manager. Si vous utilisez Azure Virtual Desktop (Classic) sans objets Azure Resource Manager, consultez cet article.
Vous pouvez personnaliser les propriétés du protocole RDP (Remote Desktop Protocol) d’un pool d’hôtes, comme l’utilisation de plusieurs écrans et la redirection audio, pour offrir une expérience optimale pour vos utilisateurs en fonction de leurs besoins. Si vous souhaitez modifier les propriétés du fichier RDP par défaut, vous pouvez personnaliser les propriétés RDP dans Azure Virtual Desktop en utilisant le Portail Azure ou le paramètre -CustomRdpProperty dans la cmdlet Update-AzWvdHostPool.
Pour obtenir la liste complète des propriétés prises en charge et de leurs valeurs par défaut, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop.
Propriétés de fichier RDP par défaut
Les fichiers RDP ont les propriétés suivantes par défaut :
| Propriété RDP | Pour les applications de bureau et RemoteApp |
|---|---|
| Mode à plusieurs écrans | activé |
| Redirections activées | Lecteurs, Presse-papiers, imprimantes, ports COM, cartes à puce, appareils, magasin d’appareils USB et WebAuthn |
| Mode audio distant | Lire localement |
| VideoPlayback | activé |
| EnableCredssp | activé |
Important
Le mode multimoniteur ne s’applique qu’aux groupes d’applications Desktop. Il est ignoré pour les groupes d’applications RemoteApp.
Toutes les propriétés de fichier RDP par défaut sont exposées dans le Portail Azure.
Un champ CustomRdpProperty nul appliquera toutes les propriétés RDP par défaut à votre pool d’hôtes. Un champ CustomRdpProperty vide n’applique aucune propriété RDP par défaut à votre pool d’hôtes.
Si vous configurez également les paramètres de redirection d’appareil à l’aide d’objets stratégie de groupe (GPO), les paramètres des objets de stratégie de groupe remplacent les propriétés RDP que vous spécifiez sur le pool hôte.
Prérequis
Avant de commencer, suivez les instructions fournies dans Configuration du module PowerShell Azure Virtual Desktop pour configurer votre module PowerShell et vous connecter à Azure.
Configurer les propriétés RDP dans le portail Azure
Pour configurer les propriétés RDP dans le portail Azure :
- Connectez-vous au portail Azure.
- Entrez Azure Virtual Desktop dans la barre de recherche.
- Sous Services, sélectionnez Azure Virtual Desktop.
- Dans la page Azure Virtual Desktop, dans le menu sur le côté gauche de l’écran, sélectionnez pools d’hôtes.
- Sélectionnez le nom du pool d’hôtes que vous souhaitez mettre à jour.
- Dans le menu situé sur le côté gauche de l’écran, sélectionnez Propriétés RDP.
- Définissez la propriété de votre choix.
- Vous pouvez également ouvrir l’onglet Avancé et ajouter vos propriétés RDP dans un format séparé par des points-virgules, comme les exemples PowerShell des sections suivantes.
- Lorsque vous avez terminé, sélectionnez Enregistrer pour enregistrer vos paramètres.
Les sections suivantes expliquent comment modifier manuellement des propriétés RDP personnalisées dans PowerShell.
Ajouter ou modifier une seule propriété RDP personnalisée
Pour ajouter ou modifier une seule propriété RDP personnalisée, exécutez l’applet de commande PowerShell suivante :
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty <property>
Remarque
Le service Azure Virtual Desktop n’accepte pas les caractères d’échappement tels que les points-virgules ou les deux-points comme noms de propriétés RDP personnalisées valides.
Pour vérifier si la cmdlet que vous venez d’exécuter a mis à jour la propriété, exécutez la cmdlet suivante :
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty
Name : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>
Par exemple, pour rechercher la propriété « audiocapturemode » sur un pool d’hôtes nommé 0301HP, vous devez entrer la cmdlet suivante :
Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty
Name : 0301HP
CustomRdpProperty : audiocapturemode:i:1;
Ajouter ou modifier plusieurs propriétés RDP personnalisées
Pour ajouter ou modifier plusieurs propriétés RDP personnalisées, exécutez les applets de commande PowerShell suivantes en fournissant les propriétés RDP personnalisées sous forme de chaîne avec des points-virgules comme séparateur :
$properties="<property1>;<property2>;<property3>"
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty $properties
Remarque
Le service Azure Virtual Desktop n’accepte pas les caractères d’échappement tels que les points-virgules ou les deux-points comme noms de propriétés RDP personnalisées valides.
Vous pouvez vérifier que la propriété RDP a été ajoutée en exécutant la cmdlet suivante :
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty
Name : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>
Sur la base de notre exemple de cmdlet précédent, si vous configurez plusieurs propriétés RDP sur le pool d’hôtes 0301HP, votre cmdlet doit ressembler à ceci :
Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty
Name : 0301HP
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;
Réinitialiser toutes les propriétés RDP personnalisées
Vous pouvez réinitialiser des propriétés RDP personnalisées individuelles avec leur valeur par défaut en suivant les instructions indiquées dans Ajouter ou modifier une seule propriété RDP personnalisée. Vous pouvez également réinitialiser toutes les propriétés RDP personnalisées pour un pool d’hôtes en exécutant l’applet de commande PowerShell suivante :
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty ""
Pour vous assurer que vous avez correctement supprimé le paramètre, entrez la cmdlet suivante :
Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty
Name : <hostpoolname>
CustomRdpProperty : <CustomRDPpropertystring>
Étapes suivantes
Maintenant que vous avez personnalisé les propriétés RDP d’un pool d’hôtes donné, vous pouvez vous connecter à un client Azure Virtual Desktop pour les tester dans le cadre d’une session utilisateur. Les guides pratiques suivants indiquent comment se connecter à une session à l’aide du client choisi :