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 à Windows App ou à l’application Bureau à distance, les bureaux et les applications auxquels ils ont accès s’affichent. Pour chaque bureau et application, il existe un fichier correspondant .rdp qui contient toutes les propriétés de connexion à utiliser lors de la connexion à une session à distance 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 des Portail Azure, des Azure PowerShell et d’Azure CLI.

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

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

RDP, propriété	Détails
audiomode:i:0	Détermine si l’ordinateur local ou distant lit l’audio.
devicestoredirect:s:*	Détermine les périphériques qui utilisent le protocole MTP (Media Transfer Protocol) ou le protocole PTP (Picture Transfer Protocol), tels qu’un appareil photo numérique, qui sont redirigés d’un appareil Windows local vers une session à distance.
drivestoredirect:s:*	Détermine les lecteurs fixes, amovibles et réseau sur l’appareil local qui seront redirigés et disponibles dans une session à distance.
enablecredsspsupport:i:1	Détermine si le client utilisera le fournisseur de support de sécurité des informations d’identification (CredSSP) pour l’authentification, s’il 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 intelligents sur l’appareil local seront 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 autorise l’utilisation d’authentificateurs locaux (tels que les clés de Windows Hello Entreprise et de sécurité).
usbdevicestoredirect:s:*	Détermine les périphériques USB pris en charge sur l’ordinateur client qui 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 écrans de l’appareil local.
videoplaybackmode:i:1	Détermine si la connexion utilisera le streaming multimédia efficace rdp pour la lecture vidéo.

Pour obtenir la liste complète des propriétés et valeurs prises en charge, 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 Bureau à distance. Vous devrez peut-être configurer plus qu’une simple propriété RDP.

Configuration requise

Avant de pouvoir définir des propriétés RDP personnalisées sur un pool d’hôtes, vous avez besoin des éléments suivants :

• Un pool d’hôtes existant.

• Un compte Azure a attribué le rôle Contributeur du pool d’hôtes de virtualisation de bureau ou é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. Vous pouvez également utiliser l’Cloud Shell Azure.

Configurer les propriétés RDP personnalisées

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

Portail Azure

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

1. Connectez-vous au Portail Azure.

2. Dans la barre de recherche, entrez Azure Virtual Desktop et sélectionnez l’entrée de service correspondante.

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

4. Sélectionnez Propriétés RDP, puis sélectionnez 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 modifications. Les utilisateurs doivent actualiser leurs ressources pour recevoir les modifications.

Azure PowerShell

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

1. Ouvrez Azure Cloud Shell dans 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 montre comment ajouter la désactivation de la redirection du Presse-papiers et de l’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 définit uniquement la désactivation de la redirection du Presse-papiers et de l’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 CustomRdpProperty paramètre :

     $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 à 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 d’Azure CLI, utilisez les exemples suivants. Veillez à modifier les <placeholder> valeurs des vôtres. Pour obtenir la liste complète des propriétés et valeurs prises en charge, consultez Propriétés RDP prises en charge avec Azure Virtual Desktop.

1. Ouvrez Azure Cloud Shell dans le Portail Azure avec le type de terminal Bash, ou exécutez Azure CLI 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 Azure CLI localement, commencez par vous connecter avec Azure CLI, 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 de la redirection du Presse-papiers et de l’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 définit uniquement la désactivation de la redirection du Presse-papiers et de l’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 --custom-rdp-property paramètre :

     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 à 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 Bureau à distance