Définir des propriétés RDP (Remote Desktop Protocol) personnalisées sur un pool d’hôtes dans Azure Virtual Desktop

Lorsque les utilisateurs se connectent à l’application Windows ou à l’application Bureau à distance, les bureaux et les applications auxquels ils ont accès sont affichés. Pour chaque bureau et application, il existe un fichier .rdp correspondant qui contient toutes les propriétés de connexion à utiliser lors de la connexion à une session distante via le protocole RDP (Remote Desktop Protocol). Ces propriétés RDP sont définies par pool d’hôtes.

Chaque pool d’hôtes a un ensemble de propriétés et de valeurs RDP par défaut. Vous pouvez ajouter d’autres propriétés au jeu par défaut ou remplacer les valeurs par défaut en définissant des propriétés RDP personnalisées. Cet article explique comment définir des propriétés RDP personnalisées sur un pool d’hôtes à l’aide du portail Azure, d’Azure PowerShell et d’Azure CLI.

Propriétés RDP du pool d’hôtes par défaut

Les pools d’hôtes ont par défaut les propriétés et valeurs RDP suivantes :

Propriété RDP	Détails
audiomode:i:0	Détermine si la machine locale ou distante joue l’audio.
devicestoredirect:s:*	Détermine quels périphériques utilisant le protocole MTP (Media Transfer Protocol) ou le protocole PTP (Picture Transfer Protocol), comme une caméra numérique, sont redirigés d’un appareil Windows local vers une session à distance.
drivestoredirect:s:*	Détermine quels lecteurs fixes, amovibles et réseau sur l’appareil local seront redirigés et disponibles dans une session à distance.
enablecredsspsupport:i:1	Détermine l’utilisation par le client de l’authentification CredSSP (Credential Security Support Provider) si elle est disponible.
redirectclipboard:i:1	Détermine s’il faut rediriger le presse-papiers.
redirectcomports:i:1	Détermine si les ports série ou COM sur l’appareil local sont redirigés vers une session à distance.
redirectprinters:i:1	Détermine si les imprimantes disponibles sur l’appareil local sont redirigées vers une session à distance.
redirectsmartcards:i:1	Détermine si les appareils à carte à puce sur l’appareil local sont redirigés et disponibles dans une session à distance.
redirectwebauthn:i:1	Détermine si les requêtes WebAuthn d’une session à distance sont redirigées vers l’appareil local, ce qui permet l’utilisation d’authentificateurs locaux (tels que Windows Hello Entreprise et les clés de sécurité).
usbdevicestoredirect:s:*	Détermine quels périphériques USB pris en charge sur l’ordinateur client sont redirigés à l’aide d’une redirection opaque de bas niveau vers une session à distance.
use multimon:i:1	Détermine si la session à distance utilisera un ou plusieurs affichages à partir de l’appareil local.
videoplaybackmode:i:1	Détermine si la connexion utilisera le streaming multimédia adapté au protocole RDP pour la lecture de vidéo.

Pour obtenir la liste complète des propriétés prises en charge et leurs valeurs, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop

Conseil

Pour en savoir plus sur la redirection des périphériques et des ressources, consultez Redirection de périphériques et de ressources via le protocole RDP (Remote Desktop Protocol). Vous devrez peut-être configurer plus qu’une propriété RDP.

Prérequis

Pour pouvoir définir des propriétés RDP personnalisées sur un pool d’hôtes, il vous faut :

• Pool d’hôtes existant.

• Un compte Azure doté du rôle Contributeur de pool d’hôtes de virtualisation de bureau ou d’un équivalent.

• Si vous souhaitez utiliser Azure CLI ou Azure PowerShell localement, consultez Utiliser Azure CLI et Azure PowerShell avec Azure Virtual Desktop pour vous assurer que vous disposez de l’extension Azure CLI desktopvirtualization ou du module PowerShell Az.DesktopVirtualization installé. Vous pouvez également utiliser Azure Cloud Shell.

Configurer des propriétés RDP personnalisées

Sélectionnez l’onglet approprié pour votre scénario.

Azure portal

Voici comment configurer des propriétés RDP à l’aide du portail Azure. Pour obtenir la liste complète des propriétés prises en charge et leurs valeurs, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop.

1. Connectez-vous au portail Azure.

2. Dans la barre de recherche, tapez Azure Virtual Desktop, puis sélectionnez l’entrée du service correspondant.

3. Sélectionnez Pools d’hôtes, puis le nom du pool d’hôtes que vous souhaitez mettre à jour.

4. Sélectionnez Propriétés RDP, puis l’onglet Avancé.

   

5. Ajoutez des propriétés RDP supplémentaires ou apportez des modifications aux propriétés RDP existantes dans un format séparé par des points-virgules, comme les valeurs par défaut déjà affichées.

6. Lorsque vous avez terminé, sélectionnez Enregistrer pour enregistrer vos paramètres. Les utilisateurs doivent actualiser leurs ressources pour recevoir les modifications.

Azure PowerShell

Pour configurer des propriétés RDP à l’aide d’Azure PowerShell, utilisez les exemples suivants. Veillez à remplacer les valeurs <placeholder> par les vôtres. Pour obtenir la liste complète des propriétés prises en charge et leurs valeurs, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop.

1. Ouvrez Azure Cloud Shell sur le Portail Azure avec le type de terminal PowerShell ou exécutez PowerShell sur votre appareil local.

   • Si vous utilisez Cloud Shell, vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

   • Si vous utilisez PowerShell localement, commencez par vous connecter avec Azure PowerShell, puis vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

2. Utilisez l’un des exemples suivants en fonction de vos besoins :

   • Pour ajouter des propriétés RDP personnalisées à un pool d’hôtes et conserver les propriétés personnalisées existantes déjà définies, exécutez les commandes suivantes. Les propriétés RDP doivent être écrites dans un format séparé par des points-virgules. Cet exemple ajoute la désactivation du presse-papiers et la redirection d’imprimante :

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $addCustomProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     $currentCustomProperties = (Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup).CustomRdpProperty
     $customProperties = $currentCustomProperties + $addCustomProperties
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Pour remplacer toutes les propriétés personnalisées existantes par un nouvel ensemble de propriétés RDP personnalisées, exécutez la commande suivante. Cet exemple ne définit que la désactivation du presse-papiers et la redirection d’imprimante :

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Pour supprimer toutes les propriétés RDP personnalisées d’un pool d’hôtes, exécutez la commande suivante. Cet exemple transmet une chaîne vide au paramètre CustomRdpProperty :

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = ""
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

3. Vérifiez les propriétés RDP personnalisées définies sur le même pool d’hôtes en exécutant la commande suivante :

   Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
   

   La sortie doit ressembler à celle de l’exemple suivant :

    Name              : contoso-hp01
    CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Les utilisateurs doivent actualiser leurs ressources pour recevoir les modifications.

Azure CLI

Pour configurer des propriétés RDP à l’aide de l’interface de ligne de commande Azure, utilisez les exemples suivants. Veillez à remplacer les valeurs <placeholder> par les vôtres. Pour obtenir la liste complète des propriétés prises en charge et leurs valeurs, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop.

1. Ouvrez Azure Cloud Shell sur le Portail Azure avec le type de terminal Bash ou exécutez l’interface de ligne de commande Azure sur votre appareil local.

   • Si vous utilisez Cloud Shell, vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

   • Si vous utilisez l’interface de ligne de commande Azure localement, commencez par vous connecter avec l’interface de ligne de commande Azure, puis vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

2. Utilisez l’un des exemples suivants en fonction de vos besoins :

   • Pour ajouter des propriétés RDP personnalisées à un pool d’hôtes et conserver les propriétés personnalisées existantes déjà définies, exécutez les commandes suivantes. Les propriétés RDP doivent être écrites dans un format séparé par des points-virgules. Cet exemple ajoute la désactivation du presse-papiers et la redirection d’imprimante aux propriétés personnalisées existantes :

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     addCustomProperties="redirectclipboard:i:0;redirectprinters:i:0"
     
     currentCustomProperties=$(az desktopvirtualization hostpool show \
          --name $hostPool \
          --resource-group $resourceGroup \
          --query [customRdpProperty] \
          --output tsv)
     
     customProperties="$currentCustomProperties$addCustomProperties"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "$customProperties"
     

   • Pour remplacer toutes les propriétés personnalisées existantes par un nouvel ensemble de propriétés RDP personnalisées, exécutez la commande suivante. Cet exemple ne définit que la désactivation du presse-papiers et la redirection d’imprimante :

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
     

   • Pour supprimer toutes les propriétés RDP personnalisées d’un pool d’hôtes, exécutez la commande suivante. Cet exemple transmet une chaîne vide au paramètre --custom-rdp-property :

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property ""
     

3. Vérifiez les propriétés RDP personnalisées définies sur le même pool d’hôtes en exécutant la commande suivante :

   az desktopvirtualization hostpool show \
       --name $hostPool \
       --resource-group $resourceGroup \
       --query "{name:name, customRdpProperty:customRdpProperty}" \
       --output table
   

   La sortie doit ressembler à celle de l’exemple suivant :

   Name          CustomRdpProperty
   --------      ------------------------------------------------------------
   contoso-hp01  use multimon:i:0;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Les utilisateurs doivent actualiser leurs ressources pour recevoir les modifications.

Contenu connexe

• Propriétés RDP prises en charge avec Azure Virtual Desktop
• Redirection de périphériques et de ressources via le protocole RDP (Remote Desktop Protocol)