Ange anpassade RDP-egenskaper (Remote Desktop Protocol) i en värdpool i Azure Virtual Desktop

När användare loggar in på Windows-appen eller fjärrskrivbordsappen visas skrivbord och program som de har åtkomst till. För varje skrivbord och program finns det en motsvarande .rdp fil som innehåller alla anslutningsegenskaper som ska användas när du ansluter till en fjärrsession via RDP (Remote Desktop Protocol). Dessa RDP-egenskaper anges per värdpool.

Varje värdpool har en uppsättning RDP-standardegenskaper och -värden. Du kan lägga till andra egenskaper i standarduppsättningen eller åsidosätta standardvärdena genom att ange anpassade RDP-egenskaper. Den här artikeln visar hur du anger anpassade RDP-egenskaper i en värdpool med hjälp av Azure-portalen, Azure PowerShell och Azure CLI.

Rdp-egenskaper för standardvärdpool

Värdpooler har följande RDP-egenskaper och -värden som standard:

RDP-egenskap	Details
audiomode:i:0	Avgör om den lokala datorn eller fjärrdatorn spelar upp ljud.
devicestoredirect:s:*	Avgör vilken kringutrustning som använder Media Transfer Protocol (MTP) eller Picture Transfer Protocol (PTP), till exempel en digital kamera, omdirigeras från en lokal Windows-enhet till en fjärrsession.
drivestoredirect:s:*	Avgör vilka fasta, flyttbara enheter och nätverksenheter på den lokala enheten som ska omdirigeras och vara tillgängliga i en fjärrsession.
enablecredsspsupport:i:1	Avgör om klienten ska använda CredSSP (CredSSP) för autentisering om den är tillgänglig.
redirectclipboard:i:1	Avgör om Urklipp ska omdirigeras.
redirectcomports:i:1	Avgör om serie- eller COM-portar på den lokala enheten omdirigeras till en fjärrsession.
redirectprinters:i:1	Avgör om skrivare som är tillgängliga på den lokala enheten omdirigeras till en fjärrsession.
redirectsmartcards:i:1	Avgör om smartkortsenheter på den lokala enheten ska omdirigeras och vara tillgängliga i en fjärrsession.
redirectwebauthn:i:1	Avgör om WebAuthn-begäranden från en fjärrsession omdirigeras till den lokala enheten som tillåter användning av lokala autentiseringsfunktioner (till exempel Windows Hello za posao och säkerhetsnycklar).
usbdevicestoredirect:s:*	Avgör vilka USB-enheter som stöds på klientdatorn omdirigeras med ogenomskinlig omdirigering på låg nivå till en fjärrsession.
use multimon:i:1	Avgör om fjärrsessionen ska använda en eller flera skärmar från den lokala enheten.
videoplaybackmode:i:1	Avgör om anslutningen ska använda RDP-effektiv multimedieströmning för videouppspelning.

En fullständig lista över egenskaper och värden som stöds finns i RDP-egenskaper som stöds med Azure Virtual Desktop

Dricks

Mer information om hur du omdirigerar kringutrustning och resurser finns i Omdirigering av kringutrustning och resurser via Fjärrskrivbordsprotokollet. Du kan behöva konfigurera mer än bara en RDP-egenskap.

Förutsättningar

Innan du kan ange anpassade RDP-egenskaper i en värdpool behöver du:

• En befintlig värdpool.

• Ett Azure-konto som tilldelats rollen Desktop Virtualization Host Pool Contributor eller motsvarande.

• Om du vill använda Azure CLI eller Azure PowerShell lokalt kan du läsa Använda Azure CLI och Azure PowerShell med Azure Virtual Desktop för att se till att du har Azure CLI-tillägget för skrivbordsmiljö eller Az.DesktopVirtualization PowerShell-modulen installerad. Du kan också använda Azure Cloud Shell.

Konfigurera anpassade RDP-egenskaper

Välj relevant flik för ditt scenario.

Azure Portal

Så här konfigurerar du RDP-egenskaper med hjälp av Azure-portalen. En fullständig lista över egenskaper och värden som stöds finns i RDP-egenskaper som stöds med Azure Virtual Desktop.

1. Logga in på Azure-portalen.

2. I sökfältet anger du Azure Virtual Desktop och väljer posten matchande tjänst.

3. Välj Värdpooler och välj sedan namnet på den värdpool som du vill uppdatera.

4. Välj RDP-egenskaper och välj sedan fliken Avancerat .

   

5. Lägg till extra RDP-egenskaper eller gör ändringar i befintliga RDP-egenskaper i ett semikolonavgränsat format, som standardvärdena som redan visas.

6. När du är klar väljer du Spara för att spara ändringarna. Användarna måste uppdatera sina resurser för att få ändringarna.

Azure PowerShell

Använd följande exempel för att konfigurera RDP-egenskaper med Hjälp av Azure PowerShell. Se till att ändra <placeholder> värdena för dina egna. En fullständig lista över egenskaper och värden som stöds finns i RDP-egenskaper som stöds med Azure Virtual Desktop.

1. Öppna Azure Cloud Shell i Azure-portalen med PowerShell-terminaltypen eller kör PowerShell på din lokala enhet.

   • Om du använder Cloud Shell kontrollerar du att Azure-kontexten är inställd på den prenumeration som du vill använda.

   • Om du använder PowerShell lokalt loggar du först in med Azure PowerShell och kontrollerar sedan att Azure-kontexten är inställd på den prenumeration som du vill använda.

2. Använd något av följande exempel baserat på dina krav:

   • Om du vill lägga till anpassade RDP-egenskaper i en värdpool och behålla befintliga anpassade egenskaper som redan har angetts kör du följande kommandon. RDP-egenskaper måste skrivas i ett semikolonavgränsat format. Det här exemplet lägger till omdirigering av urklipp och skrivare:

     $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
     

   • Om du vill ersätta alla befintliga anpassade egenskaper med en ny uppsättning anpassade RDP-egenskaper kör du följande kommando. I det här exemplet anges endast inaktivering av Urklipp och skrivaromdirigering:

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

   • Kör följande kommando för att ta bort alla anpassade RDP-egenskaper från en värdpool. Det här exemplet skickar en tom sträng till parametern CustomRdpProperty :

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

3. Kontrollera de anpassade RDP-egenskaperna som angetts i samma värdpool genom att köra följande kommando:

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

   Utdata bör likna följande exempel:

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

4. Användarna måste uppdatera sina resurser för att få ändringarna.

Azure CLI

Använd följande exempel för att konfigurera RDP-egenskaper med Hjälp av Azure CLI. Se till att ändra <placeholder> värdena för dina egna. En fullständig lista över egenskaper och värden som stöds finns i RDP-egenskaper som stöds med Azure Virtual Desktop.

1. Öppna Azure Cloud Shell i Azure-portalen med Bash-terminaltypen eller kör Azure CLI på din lokala enhet.

   • Om du använder Cloud Shell kontrollerar du att Azure-kontexten är inställd på den prenumeration som du vill använda.

   • Om du använder Azure CLI lokalt loggar du först in med Azure CLI och kontrollerar sedan att Azure-kontexten är inställd på den prenumeration som du vill använda.

2. Använd något av följande exempel baserat på dina krav:

   • Om du vill lägga till anpassade RDP-egenskaper i en värdpool och behålla befintliga anpassade egenskaper som redan har angetts kör du följande kommandon. RDP-egenskaper måste skrivas i ett semikolonavgränsat format. Det här exemplet lägger till omdirigering av inaktivering av Urklipp och skrivaromdirigering till de befintliga anpassade egenskaperna:

     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"
     

   • Om du vill ersätta alla befintliga anpassade egenskaper med en ny uppsättning anpassade RDP-egenskaper kör du följande kommando. I det här exemplet anges endast inaktivering av Urklipp och skrivaromdirigering:

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

   • Kör följande kommando för att ta bort alla anpassade RDP-egenskaper från en värdpool. Det här exemplet skickar en tom sträng till parametern --custom-rdp-property :

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

3. Kontrollera de anpassade RDP-egenskaperna som angetts i samma värdpool genom att köra följande kommando:

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

   Utdata bör likna följande exempel:

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

4. Användarna måste uppdatera sina resurser för att få ändringarna.

Relaterat innehåll

• RDP-egenskaper som stöds med Azure Virtual Desktop
• Omdirigering av kringutrustning och resurser via fjärrskrivbordsprotokollet