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

Когда пользователи входят в приложение Windows или приложение удаленного рабочего стола, рабочие столы и приложения, к которым они имеют доступ. Для каждого рабочего стола и приложения существует соответствующий .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 для настольных компьютеров или модуль PowerShell Az.DesktopVirtualization. Кроме того, используйте Azure Cloud Shell.

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

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

Портал Azure

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

1. Войдите на портал Azure.

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

3. Выберите пулы узлов, а затем выберите имя пула узлов, который требуется обновить.

4. Выберите свойства RDP, а затем перейдите на вкладку "Дополнительно ".

   

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

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

Azure PowerShell

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

1. Откройте Azure Cloud Shell в портал Azure с типом терминала PowerShell или запустите PowerShell на локальном устройстве.

   • Если вы используете Cloud Shell, убедитесь, что контекст Azure установлен в подписке, которую вы хотите использовать.

   • Если вы используете PowerShell локально, сначала войдите в Azure PowerShell, а затем убедитесь , что контекст Azure установлен в подписке, которую вы хотите использовать.

2. Используйте один из следующих примеров на основе ваших требований:

   • Чтобы добавить настраиваемые свойства 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
     

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

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

   Выходные данные должны быть похожи на следующий пример:

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

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

Azure CLI

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

1. Откройте Azure Cloud Shell в портал Azure с типом терминала Bash или запустите Azure CLI на локальном устройстве.

   • Если вы используете Cloud Shell, убедитесь, что контекст Azure установлен в подписке, которую вы хотите использовать.

   • Если вы используете Azure CLI локально, сначала войдите в Azure CLI, а затем убедитесь , что контекст Azure установлен в подписке, которую вы хотите использовать.

2. Используйте один из следующих примеров на основе ваших требований:

   • Чтобы добавить настраиваемые свойства 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 ""
     

3. Проверьте настраиваемые свойства 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;
   

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

Связанный контент

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