Aangepaste RDP-eigenschappen (Remote Desktop Protocol) instellen in een hostgroep in Azure Virtual Desktop

Wanneer gebruikers zich aanmelden bij de Windows-app of de app Extern bureaublad, worden bureaubladen en toepassingen waartoe ze toegang hebben weergegeven. Voor elk bureaublad en elke toepassing is er een bijbehorend .rdp bestand dat alle verbindingseigenschappen bevat die moeten worden gebruikt bij het maken van verbinding met een externe sessie via remote Desktop Protocol (RDP). Deze RDP-eigenschappen worden per hostgroep ingesteld.

Elke hostgroep heeft een set standaard-RDP-eigenschappen en -waarden. U kunt andere eigenschappen toevoegen aan de standaardinstelling of de standaardwaarden overschrijven door aangepaste RDP-eigenschappen in te stellen. In dit artikel leest u hoe u aangepaste RDP-eigenschappen instelt voor een hostgroep met behulp van Azure Portal, Azure PowerShell en Azure CLI.

RdP-eigenschappen van standaardhostgroep

Hostgroepen hebben standaard de volgende RDP-eigenschappen en -waarden:

RDP-eigenschap	DETAILS
audiomode:i:0	Bepaalt of de lokale of externe computer audio afspeelt.
devicestoredirect:s:*	Bepaalt welke randapparatuur die gebruikmaakt van het Media Transfer Protocol (MTP) of Picture Transfer Protocol (PTP), zoals een digitale camera, wordt omgeleid van een lokaal Windows-apparaat naar een externe sessie.
drivestoredirect:s:*	Bepaalt welke vaste, verwisselbare en netwerkstations op het lokale apparaat worden omgeleid en beschikbaar zijn in een externe sessie.
enablecredsspsupport:i:1	Bepaalt of de client de Referentiebeveiligingsondersteuningsprovider (CredSSP) gebruikt voor verificatie als deze beschikbaar is.
redirectclipboard:i:1	Bepaalt of het klembord moet worden omgeleid.
redirectcomports:i:1	Bepaalt of seriële of COM-poorten op het lokale apparaat worden omgeleid naar een externe sessie.
redirectprinters:i:1	Bepaalt of printers die beschikbaar zijn op het lokale apparaat, worden omgeleid naar een externe sessie.
redirectsmartcards:i:1	Bepaalt of smartcardapparaten op het lokale apparaat worden omgeleid en beschikbaar zijn in een externe sessie.
redirectwebauthn:i:1	Bepaalt of WebAuthn-aanvragen van een externe sessie worden omgeleid naar het lokale apparaat, zodat lokale verificators (zoals Windows Hello voor Bedrijven en beveiligingssleutels) kunnen worden gebruikt.
usbdevicestoredirect:s:*	Bepaalt welke ondersteunde USB-apparaten op de clientcomputer worden omgeleid met ondoorzichtige omleiding op laag niveau naar een externe sessie.
use multimon:i:1	Bepaalt of de externe sessie een of meer beeldschermen van het lokale apparaat gebruikt.
videoplaybackmode:i:1	Bepaalt of de verbinding RDP-efficiënte multimediastreaming gebruikt voor het afspelen van video's.

Zie Ondersteunde RDP-eigenschappen met Azure Virtual Desktop voor een volledige lijst met ondersteunde eigenschappen en waarden

Tip

Zie Randapparatuur en resourceomleiding via het Remote Desktop Protocol voor meer informatie over het omleiden van randapparatuur en resources. Mogelijk moet u meer dan alleen een RDP-eigenschap configureren.

Vereisten

Voordat u aangepaste RDP-eigenschappen voor een hostgroep kunt instellen, hebt u het volgende nodig:

• Een bestaande hostgroep.

• Aan een Azure-account is de rol Inzender van hostgroep desktopvirtualisatie toegewezen of een equivalent.

• Als u Azure CLI of Azure PowerShell lokaal wilt gebruiken, raadpleegt u Azure CLI en Azure PowerShell gebruiken met Azure Virtual Desktop om te controleren of u de Azure CLI-extensie desktopvirtualisatie of de PowerShell-module Az.DesktopVirtualization hebt geïnstalleerd. U kunt ook de Azure Cloud Shell gebruiken.

Aangepaste RDP-eigenschappen configureren

Selecteer het relevante tabblad voor uw scenario.

Azure-portal

U kunt als volgt RDP-eigenschappen configureren met behulp van Azure Portal. Zie Ondersteunde RDP-eigenschappen met Azure Virtual Desktop voor een volledige lijst met ondersteunde eigenschappen en waarden.

1. Meld u aan bij het Azure-portaal.

2. Voer in de zoekbalk Azure Virtual Desktop in en selecteer de overeenkomende servicevermelding.

3. Selecteer Hostgroepen en selecteer vervolgens de naam van de hostgroep die u wilt bijwerken.

4. Selecteer RDP-eigenschappen en selecteer vervolgens het tabblad Geavanceerd .

   

5. Voeg extra RDP-eigenschappen toe of breng wijzigingen aan in de bestaande RDP-eigenschappen in een door puntkomma's gescheiden indeling, zoals de standaardwaarden die al worden weergegeven.

6. Wanneer u klaar bent, selecteert u Opslaan om uw wijzigingen op te slaan. Gebruikers moeten hun resources vernieuwen om de wijzigingen te ontvangen.

Azure PowerShell

Gebruik de volgende voorbeelden om RDP-eigenschappen te configureren met behulp van Azure PowerShell. Zorg ervoor dat u de <placeholder> waarden voor uw eigen waarden wijzigt. Zie Ondersteunde RDP-eigenschappen met Azure Virtual Desktop voor een volledige lijst met ondersteunde eigenschappen en waarden.

1. Open Azure Cloud Shell in Azure Portal met het PowerShell-terminaltype of voer PowerShell uit op uw lokale apparaat.

   • Als u Cloud Shell gebruikt, moet u ervoor zorgen dat uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

   • Als u PowerShell lokaal gebruikt, meldt u zich eerst aan met Azure PowerShell en controleert u of uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

2. Gebruik een van de volgende voorbeelden op basis van uw vereisten:

   • Als u aangepaste RDP-eigenschappen wilt toevoegen aan een hostgroep en bestaande aangepaste eigenschappen al wilt instellen, voert u de volgende opdrachten uit. RDP-eigenschappen moeten worden geschreven in een door puntkomma's gescheiden indeling. In dit voorbeeld wordt het uitschakelen van klembord en printeromleiding toegevoegd:

     $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
     

   • Als u alle bestaande aangepaste eigenschappen wilt vervangen door een nieuwe set aangepaste RDP-eigenschappen, voert u de volgende opdracht uit. In dit voorbeeld wordt alleen het uitschakelen van klembord en printeromleiding ingesteld:

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

   • Als u alle aangepaste RDP-eigenschappen uit een hostgroep wilt verwijderen, voert u de volgende opdracht uit. In dit voorbeeld wordt een lege tekenreeks doorgegeven aan de CustomRdpProperty parameter:

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

3. Controleer de aangepaste RDP-eigenschappen die zijn ingesteld op dezelfde hostgroep door de volgende opdracht uit te voeren:

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

   De uitvoer moet er ongeveer uitzien als in het volgende voorbeeld:

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

4. Gebruikers moeten hun resources vernieuwen om de wijzigingen te ontvangen.

Azure-CLI

Gebruik de volgende voorbeelden om RDP-eigenschappen te configureren met behulp van Azure CLI. Zorg ervoor dat u de <placeholder> waarden voor uw eigen waarden wijzigt. Zie Ondersteunde RDP-eigenschappen met Azure Virtual Desktop voor een volledige lijst met ondersteunde eigenschappen en waarden.

1. Open Azure Cloud Shell in Azure Portal met het Bash-terminaltype of voer de Azure CLI uit op uw lokale apparaat.

   • Als u Cloud Shell gebruikt, moet u ervoor zorgen dat uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

   • Als u de Azure CLI lokaal gebruikt, meldt u zich eerst aan met de Azure CLI en controleert u of uw Azure-context is ingesteld op het abonnement dat u wilt gebruiken.

2. Gebruik een van de volgende voorbeelden op basis van uw vereisten:

   • Als u aangepaste RDP-eigenschappen wilt toevoegen aan een hostgroep en bestaande aangepaste eigenschappen al wilt instellen, voert u de volgende opdrachten uit. RDP-eigenschappen moeten worden geschreven in een door puntkomma's gescheiden indeling. In dit voorbeeld wordt het uitschakelen van klembord en printeromleiding toegevoegd aan de bestaande aangepaste eigenschappen:

     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"
     

   • Als u alle bestaande aangepaste eigenschappen wilt vervangen door een nieuwe set aangepaste RDP-eigenschappen, voert u de volgende opdracht uit. In dit voorbeeld wordt alleen het uitschakelen van klembord en printeromleiding ingesteld:

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

   • Als u alle aangepaste RDP-eigenschappen uit een hostgroep wilt verwijderen, voert u de volgende opdracht uit. In dit voorbeeld wordt een lege tekenreeks doorgegeven aan de --custom-rdp-property parameter:

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

3. Controleer de aangepaste RDP-eigenschappen die zijn ingesteld op dezelfde hostgroep door de volgende opdracht uit te voeren:

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

   De uitvoer moet er ongeveer uitzien als in het volgende voorbeeld:

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

4. Gebruikers moeten hun resources vernieuwen om de wijzigingen te ontvangen.

Gerelateerde inhoud

• Ondersteunde RDP-eigenschappen met Azure Virtual Desktop
• Randapparatuur en resourceomleiding via het Remote Desktop Protocol