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 Windows App lub aplikacji pulpitu zdalnego, wyświetlane są 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, które mają być używane 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 przedstawiono sposób ustawiania niestandardowych właściwości protokołu RDP w puli hostów przy użyciu Azure Portal, 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 komputer lokalny czy zdalny 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 stałe, wymienne i sieciowe dyski na urządzeniu lokalnym będą przekierowywane 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 przekierowywać 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 z kartami inteligentnymi na urządzeniu lokalnym będą przekierowywane i dostępne w sesji zdalnej.
`redirectwebauthn:i:1`	Określa, czy żądania webauthn z sesji zdalnej są przekierowywane do urządzenia lokalnego, co umożliwia korzystanie z lokalnych wystawców uwierzytelniania (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 przekierowywania niskiego poziomu do sesji zdalnej.
`use multimon:i:1`	Określa, czy sesja zdalna będzie używać jednego lub wielu wyświetlaczy z urządzenia lokalnego.
`videoplaybackmode:i:1`	Określa, czy połączenie będzie używać wydajnego przesyłania strumieniowego multimediów RDP na potrzeby 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

Porada

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

Wymagania wstępne

Aby można było ustawić niestandardowe właściwości protokołu RDP w puli hostów, musisz wykonać następujące czynności:

Istniejąca pula hostów.
Konto platformy Azure przypisano rolę współautora puli hostów wirtualizacji pulpitu lub równoważną.
Jeśli chcesz używać interfejsu wiersza polecenia platformy Azure lub Azure PowerShell lokalnie, zobacz Używanie interfejsu wiersza polecenia platformy Azure i Azure PowerShell z usługą Azure Virtual Desktop, aby upewnić się, że masz zainstalowane rozszerzenie interfejsu wiersza polecenia platformy Azure do pulpituwitualizacji 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.

Poniżej przedstawiono sposób konfigurowania właściwości protokołu RDP przy użyciu 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.

Zaloguj się do witryny Azure Portal.
Na pasku wyszukiwania wprowadź ciąg Azure Virtual Desktop i wybierz odpowiedni wpis usługi.
Wybierz pozycję Pule hostów, a następnie wybierz nazwę puli hostów, którą chcesz zaktualizować.
Wybierz pozycję Właściwości PROTOKOŁU RDP, a następnie wybierz kartę Zaawansowane .
Dodaj dodatkowe właściwości PROTOKOŁU RDP lub wprowadź zmiany w istniejących właściwościach PROTOKOŁU RDP w formacie rozdzielonym średnikami, podobnie jak wartości domyślne już wyświetlane.
Po zakończeniu wybierz pozycję Zapisz , aby zapisać zmiany. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Aby skonfigurować właściwości protokołu RDP przy użyciu 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.

Otwórz usługę Azure Cloud Shell w Azure Portal z typem terminalu programu PowerShell lub uruchom program PowerShell na urządzeniu lokalnym.
- Jeśli używasz 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 Azure PowerShell, a następnie upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

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 rozdzielonym średnikami. W tym przykładzie dodano wyłączenie przekierowywania schowka i 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 jest ustawiane tylko wyłączanie przekierowywania schowka i 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 przekazuje pusty ciąg do parametru CustomRdpProperty :

$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = ""

Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties

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;

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

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.

Otwórz usługę Azure Cloud Shell w Azure Portal z typem terminalu powłoki Bash lub uruchom interfejs wiersza polecenia platformy Azure na urządzeniu lokalnym.
- Jeśli używasz 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ć.

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 rozdzielonym średnikami. W tym przykładzie do istniejących właściwości niestandardowych dodano wyłączenie przekierowywania schowka i drukarki:

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 jest ustawiane tylko wyłączanie przekierowywania schowka i 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 przekazuje pusty ciąg do parametru --custom-rdp-property :

hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"

az desktopvirtualization hostpool update \
     --name $hostPool \
     --resource-group $resourceGroup \
     --custom-rdp-property ""

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;

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-06-20

Udostępnij przez

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

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

Wymagania wstępne

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

Zawartość pokrewna

Sprzężenie zwrotne

Dodatkowe źródła