Ustawianie niestandardowych właściwości protokołu RDP (Remote Desktop Protocol) w puli hostów w usłudze Azure Virtual Desktop

Gdy użytkownicy logują się do aplikacji systemu Windows lub aplikacji pulpitu zdalnego, są wyświetlane pulpity i aplikacje, do których mają dostęp. Dla każdego pulpitu i aplikacji istnieje odpowiedni .rdp plik zawierający wszystkie właściwości połączenia do użycia podczas nawiązywania połączenia z sesją zdalną za pośrednictwem protokołu RDP (Remote Desktop Protocol). Te właściwości protokołu RDP są ustawiane dla puli hostów.

Każda pula hostów ma zestaw domyślnych właściwości i wartości protokołu RDP. Możesz dodać inne właściwości do domyślnego zestawu lub zastąpić wartości domyślne, ustawiając niestandardowe właściwości protokołu RDP. W tym artykule pokazano, jak ustawić niestandardowe właściwości protokołu RDP w puli hostów przy użyciu witryny Azure Portal, programu Azure PowerShell i interfejsu wiersza polecenia platformy Azure.

Domyślne właściwości protokołu RDP puli hostów

Pule hostów mają domyślnie następujące właściwości i wartości protokołu RDP:

Właściwość RDP	Szczegóły
audiomode:i:0	Określa, czy maszyna lokalna lub zdalna odtwarza dźwięk.
devicestoredirect:s:*	Określa, które urządzenia peryferyjne korzystające z protokołu MTP (Media Transfer Protocol) lub Protokołu TRANSFERU obrazów (PTP), takie jak aparat cyfrowy, są przekierowywane z lokalnego urządzenia z systemem Windows do sesji zdalnej.
drivestoredirect:s:*	Określa, które dyski stałe, wymienne i sieciowe na urządzeniu lokalnym zostaną przekierowane i dostępne w sesji zdalnej.
enablecredsspsupport:i:1	Określa, czy klient będzie używać dostawcy obsługi zabezpieczeń poświadczeń (CredSSP) do uwierzytelniania, jeśli jest dostępny.
redirectclipboard:i:1	Określa, czy należy przekierować schowek.
redirectcomports:i:1	Określa, czy porty szeregowe lub COM na urządzeniu lokalnym są przekierowywane do sesji zdalnej.
redirectprinters:i:1	Określa, czy drukarki dostępne na urządzeniu lokalnym są przekierowywane do sesji zdalnej.
redirectsmartcards:i:1	Określa, czy urządzenia kart inteligentnych na urządzeniu lokalnym zostaną przekierowane i dostępne w sesji zdalnej.
redirectwebauthn:i:1	Określa, czy żądania WebAuthn z sesji zdalnej są przekierowywane do urządzenia lokalnego zezwalającego na korzystanie z lokalnych wystawców uwierzytelnienia (takich jak Windows Hello dla firm i klucze zabezpieczeń).
usbdevicestoredirect:s:*	Określa, które obsługiwane urządzenia USB na komputerze klienckim są przekierowywane przy użyciu nieprzezroczystego przekierowania niskiego poziomu do sesji zdalnej.
use multimon:i:1	Określa, czy sesja zdalna będzie używać jednego lub wielu ekranów z urządzenia lokalnego.
videoplaybackmode:i:1	Określa, czy połączenie będzie używać wydajnego przesyłania strumieniowego multimediów RDP do odtwarzania wideo.

Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop

Napiwek

Aby dowiedzieć się więcej na temat przekierowywania urządzeń peryferyjnych i zasobów, zobacz Przekierowywanie urządzeń peryferyjnych i zasobów za pośrednictwem protokołu Remote Desktop Protocol. Może być konieczne skonfigurowanie więcej niż tylko właściwości protokołu RDP.

Wymagania wstępne

Przed ustawieniem niestandardowych właściwości protokołu RDP w puli hostów potrzebne są następujące elementy:

• Istniejąca pula hostów.

• Konto platformy Azure ma przypisaną rolę Współautor puli hostów wirtualizacji pulpitu lub jej odpowiednik.

• Jeśli chcesz używać interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell lokalnie, zobacz Używanie interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell z usługą Azure Virtual Desktop, aby upewnić się, że masz zainstalowane rozszerzenie interfejsu wiersza polecenia platformy Azure dla pulpitu lub moduł Az.DesktopVirtualization programu PowerShell. Alternatywnie użyj usługi Azure Cloud Shell.

Konfigurowanie niestandardowych właściwości protokołu RDP

Wybierz odpowiednią kartę dla danego scenariusza.

Azure Portal

Poniżej przedstawiono sposób konfigurowania właściwości protokołu RDP przy użyciu witryny Azure Portal. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Zaloguj się w witrynie Azure Portal.

2. Na pasku wyszukiwania wprowadź ciąg Azure Virtual Desktop i wybierz pasujący wpis usługi.

3. Wybierz pozycję Pule hostów, a następnie wybierz nazwę puli hostów, którą chcesz zaktualizować.

4. Wybierz pozycję Właściwości protokołu RDP, a następnie wybierz kartę Zaawansowane .

   

5. Dodaj dodatkowe właściwości protokołu RDP lub wprowadź zmiany w istniejących właściwościach protokołu RDP w formacie rozdzielanym średnikami, tak jak pokazano już wartości domyślne.

6. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz , aby zapisać zmiany. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Azure PowerShell

Aby skonfigurować właściwości protokołu RDP przy użyciu programu Azure PowerShell, skorzystaj z poniższych przykładów. Pamiętaj, aby zmienić <placeholder> własne wartości. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Otwórz usługę Azure Cloud Shell w witrynie Azure Portal z typem terminalu programu PowerShell lub uruchom program PowerShell na urządzeniu lokalnym.

   • Jeśli używasz usługi Cloud Shell, upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

   • Jeśli używasz programu PowerShell lokalnie, najpierw zaloguj się przy użyciu programu Azure PowerShell, a następnie upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

2. Użyj jednego z następujących przykładów na podstawie wymagań:

   • Aby dodać niestandardowe właściwości protokołu RDP do puli hostów i zachować wszystkie istniejące właściwości niestandardowe już ustawione, uruchom następujące polecenia. Właściwości protokołu RDP muszą być zapisywane w formacie rozdzielanym średnikami. W tym przykładzie dodano wyłączenie schowka i przekierowania drukarki:

     $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
     

   • Aby zastąpić wszystkie istniejące właściwości niestandardowe nowym zestawem niestandardowych właściwości protokołu RDP, uruchom następujące polecenie. W tym przykładzie ustawia się tylko wyłączenie schowka i przekierowania drukarki:

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

   • Aby usunąć wszystkie niestandardowe właściwości protokołu RDP z puli hostów, uruchom następujące polecenie. W tym przykładzie do parametru CustomRdpProperty przekazuje pusty ciąg:

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

3. Sprawdź niestandardowe właściwości protokołu RDP ustawione w tej samej puli hostów, uruchamiając następujące polecenie:

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

   Dane wyjściowe powinny być podobne do następującego przykładu:

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

4. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Interfejs wiersza polecenia platformy Azure

Aby skonfigurować właściwości protokołu RDP przy użyciu interfejsu wiersza polecenia platformy Azure, skorzystaj z poniższych przykładów. Pamiętaj, aby zmienić <placeholder> własne wartości. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Otwórz usługę Azure Cloud Shell w witrynie Azure Portal z typem terminalu powłoki Bash lub uruchom interfejs wiersza polecenia platformy Azure na urządzeniu lokalnym.

   • Jeśli używasz usługi Cloud Shell, upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

   • Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, najpierw zaloguj się przy użyciu interfejsu wiersza polecenia platformy Azure, a następnie upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

2. Użyj jednego z następujących przykładów na podstawie wymagań:

   • Aby dodać niestandardowe właściwości protokołu RDP do puli hostów i zachować wszystkie istniejące właściwości niestandardowe już ustawione, uruchom następujące polecenia. Właściwości protokołu RDP muszą być zapisywane w formacie rozdzielanym średnikami. W tym przykładzie dodano wyłączenie schowka i przekierowania drukarki do istniejących właściwości niestandardowych:

     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"
     

   • Aby zastąpić wszystkie istniejące właściwości niestandardowe nowym zestawem niestandardowych właściwości protokołu RDP, uruchom następujące polecenie. W tym przykładzie ustawia się tylko wyłączenie schowka i przekierowania drukarki:

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

   • Aby usunąć wszystkie niestandardowe właściwości protokołu RDP z puli hostów, uruchom następujące polecenie. W tym przykładzie do parametru --custom-rdp-property przekazuje pusty ciąg:

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

3. Sprawdź niestandardowe właściwości protokołu RDP ustawione w tej samej puli hostów, uruchamiając następujące polecenie:

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

   Dane wyjściowe powinny być podobne do następującego przykładu:

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

4. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Powiązana zawartość

• Obsługiwane właściwości protokołu RDP w usłudze Azure Virtual Desktop
• Przekierowywanie urządzeń peryferyjnych i zasobów za pośrednictwem protokołu Remote Desktop Protocol