Настройка настраиваемых свойств протокола удаленного рабочего стола (RDP) в пуле узлов в Виртуальном рабочем столе Azure

При входе пользователей в Windows App или приложение удаленного рабочего стола отображаются рабочие столы и приложения, к которым у них есть доступ. Для каждого рабочего стола и приложения имеется соответствующий .rdp файл, содержащий все свойства подключения, которые следует использовать при подключении к удаленному сеансу по протоколу удаленного рабочего стола (RDP). Эти свойства RDP задаются для каждого пула узлов.

Каждый пул узлов имеет набор свойств и значений RDP по умолчанию. Вы можете добавить другие свойства в набор по умолчанию или переопределить значения по умолчанию, задав настраиваемые свойства RDP. В этой статье показано, как задать настраиваемые свойства RDP в пуле узлов с помощью портал Azure, Azure PowerShell и Azure CLI.

Свойства RDP пула узлов по умолчанию

Пулы узлов по умолчанию имеют следующие свойства и значения RDP:

Свойство RDP	Сведения
`audiomode:i:0`	Определяет, воспроизводит ли звук локальный или удаленный компьютер.
`devicestoredirect:s:*`	Определяет, какие периферийные устройства, использующие протокол передачи мультимедиа (MTP) или протокол передачи изображений (PTP), например цифровую камеру, перенаправляются с локального устройства Windows в удаленный сеанс.
`drivestoredirect:s:*`	Определяет, какие фиксированные, съемные и сетевые диски на локальном устройстве будут перенаправлены и доступны в удаленном сеансе.
`enablecredsspsupport:i:1`	Определяет, будет ли клиент использовать поставщик поддержки безопасности учетных данных (CredSSP) для проверки подлинности, если он доступен.
`redirectclipboard:i:1`	Определяет, следует ли перенаправлять буфер обмена.
`redirectcomports:i:1`	Определяет, перенаправляются ли последовательные или COM-порты на локальном устройстве в удаленный сеанс.
`redirectprinters:i:1`	Определяет, перенаправляются ли принтеры, доступные на локальном устройстве, в удаленный сеанс.
`redirectsmartcards:i:1`	Определяет, будут ли устройства смарт-карта на локальном устройстве перенаправляться и быть доступны в удаленном сеансе.
`redirectwebauthn:i:1`	Определяет, перенаправляются ли запросы WebAuthn из удаленного сеанса на локальное устройство, что позволяет использовать локальные средства проверки подлинности (например, Windows Hello для бизнеса и ключи безопасности).
`usbdevicestoredirect:s:*`	Определяет, какие поддерживаемые USB-устройства на клиентском компьютере перенаправляются с помощью непрозрачного перенаправления низкого уровня в удаленный сеанс.
`use multimon:i:1`	Определяет, будет ли удаленный сеанс использовать один или несколько дисплеев с локального устройства.
`videoplaybackmode:i:1`	Определяет, будет ли подключение использовать потоковую передачу мультимедиа, эффективную по протоколу RDP, для воспроизведения видео.

Полный список поддерживаемых свойств и значений см. в статье Поддерживаемые свойства RDP с Виртуальным рабочим столом Azure.

Совет

Дополнительные сведения о перенаправлении периферийных устройств и ресурсов см. в статье Перенаправление периферийных устройств и ресурсов по протоколу удаленного рабочего стола. Возможно, потребуется настроить не только свойство RDP.

Предварительные условия

Перед настройкой настраиваемых свойств RDP в пуле узлов необходимо:

Существующий пул узлов.
Учетной записи Azure назначена роль участника пула узлов виртуализации рабочих столов или эквивалент.
Если вы хотите использовать Azure CLI или Azure PowerShell локально, см. статью Использование Azure CLI и Azure PowerShell с Виртуальным рабочим столом Azure, чтобы убедиться, что у вас установлено расширение Azure CLI для desktopvirtualization или модуль Az.DesktopVirtualization PowerShell. Кроме того, используйте Cloud Shell Azure.

Настройка настраиваемых свойств RDP

Выберите соответствующую вкладку для своего сценария.

Вот как настроить свойства RDP с помощью портал Azure. Полный список поддерживаемых свойств и значений см. в статье Поддерживаемые свойства RDP с Виртуальным рабочим столом Azure.

Войдите на портал Azure.
В строке поиска введите Виртуальный рабочий стол Azure и выберите соответствующую запись службы.
Выберите Пулы узлов, а затем выберите имя пула узлов, который требуется обновить.
Выберите Свойства RDP, а затем перейдите на вкладку Дополнительно .
Добавьте дополнительные свойства RDP или внесите изменения в существующие свойства RDP в формате, разделенном точкой с запятой, как уже показаны значения по умолчанию.
Когда все будет готово, нажмите кнопку Сохранить, чтобы сохранить изменения. Чтобы получать изменения, пользователям необходимо обновить свои ресурсы.

Чтобы настроить свойства RDP с помощью Azure PowerShell, используйте следующие примеры. Обязательно измените <placeholder> значения для собственных. Полный список поддерживаемых свойств и значений см. в статье Поддерживаемые свойства RDP с Виртуальным рабочим столом Azure.

Откройте azure Cloud Shell в портал Azure с типом терминала PowerShell или запустите PowerShell на локальном устройстве.
- Если вы используете Cloud Shell, убедитесь, что для контекста Azure задана подписка, которую вы хотите использовать.
- Если вы используете PowerShell локально, сначала войдите с помощью Azure PowerShell, а затем убедитесь, что для контекста Azure задана подписка, которую вы хотите использовать.

Используйте один из следующих примеров на основе ваших требований:
- Чтобы добавить настраиваемые свойства RDP в пул узлов и сохранить все существующие настраиваемые свойства, выполните следующие команды. Свойства RDP должны быть записаны в формате с запятой. В этом примере добавляется отключение буфера обмена и перенаправление принтера:
```
$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
```
- Чтобы заменить все существующие настраиваемые свойства новым набором настраиваемых свойств RDP, выполните следующую команду. В этом примере настраивается только отключение буфера обмена и перенаправление принтера:
```
$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = "redirectclipboard:i:0;redirectprinters:i:0"

Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
```
- Чтобы удалить все настраиваемые свойства RDP из пула узлов, выполните следующую команду. В этом примере в параметр передается пустая CustomRdpProperty строка:
```
$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = ""

Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
```
Проверьте настраиваемые свойства RDP, заданные в том же пуле узлов, выполнив следующую команду:
```
Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
```
Выходные данные должны выглядеть примерно так:
```
 Name              : contoso-hp01
 CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
```
Чтобы получать изменения, пользователям необходимо обновить свои ресурсы.

Чтобы настроить свойства RDP с помощью Azure CLI, используйте следующие примеры. Обязательно измените <placeholder> значения для собственных. Полный список поддерживаемых свойств и значений см. в статье Поддерживаемые свойства RDP с Виртуальным рабочим столом Azure.

Откройте azure Cloud Shell в портал Azure с типом терминала Bash или запустите Azure CLI на локальном устройстве.
- Если вы используете Cloud Shell, убедитесь, что для контекста Azure задана подписка, которую вы хотите использовать.
- Если вы используете Azure CLI локально, сначала войдите с помощью Azure CLI, а затем убедитесь, что для контекста Azure задана подписка, которую вы хотите использовать.

Используйте один из следующих примеров на основе ваших требований:
- Чтобы добавить настраиваемые свойства RDP в пул узлов и сохранить все существующие настраиваемые свойства, выполните следующие команды. Свойства RDP должны быть записаны в формате с запятой. В этом примере к существующим настраиваемым свойствам добавляется отключение буфера обмена и перенаправления принтера:
```
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"
```
- Чтобы заменить все существующие настраиваемые свойства новым набором настраиваемых свойств RDP, выполните следующую команду. В этом примере настраивается только отключение буфера обмена и перенаправление принтера:
```
hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"

az desktopvirtualization hostpool update \
     --name $hostPool \
     --resource-group $resourceGroup \
     --custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
```
- Чтобы удалить все настраиваемые свойства RDP из пула узлов, выполните следующую команду. В этом примере в параметр передается пустая --custom-rdp-property строка:
```
hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"

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

Проверьте настраиваемые свойства RDP, заданные в том же пуле узлов, выполнив следующую команду:

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

Выходные данные должны выглядеть примерно так:

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

Чтобы получать изменения, пользователям необходимо обновить свои ресурсы.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-06-20

Поделиться через

Настройка настраиваемых свойств протокола удаленного рабочего стола (RDP) в пуле узлов в Виртуальном рабочем столе Azure

Свойства RDP пула узлов по умолчанию

Предварительные условия

Настройка настраиваемых свойств RDP

Связанные материалы

Обратная связь

Дополнительные ресурсы