当用户登录到 Windows 应用或远程桌面应用时,系统会显示他们有权访问的桌面和应用程序。 对于每个桌面和应用程序,都有一个对应的 .rdp
文件,其中包含通过远程桌面协议 (RDP) 连接到远程会话时要使用的所有连接属性。 按主机池设置这些 RDP 属性。
每个主机池都有一组默认 RDP 属性和值。 可通过设置自定义 RDP 属性,将其他属性添加到默认集或替代默认值。 本文介绍如何使用 Azure 门户、Azure PowerShell 和 Azure CLI 在主机池上设置自定义 RDP 属性。
默认主机池 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 for Business 和安全密钥)的本地设备。 |
usbdevicestoredirect:s:* |
确定使用不透明低级别重定向将客户端计算机上的哪些受支持的 USB 设备重定向到远程会话。 |
use multimon:i:1 |
确定远程会话是否将使用本地设备的一个或多个显示器。 |
videoplaybackmode:i:1 |
确定连接是否将使用 RDP 高效多媒体流进行视频播放。 |
有关支持的属性和值的完整列表,请参阅 Azure 虚拟桌面支持的 RDP 属性
先决条件
在主机池上设置自定义 RDP 属性之前,需要:
选择方案的相关选项卡。
下面介绍如何使用 Azure 门户配置 RDP 属性。 有关支持的属性和值的完整列表,请参阅 Azure 虚拟桌面支持的 RDP 属性。
登录到 Azure 门户。
在搜索栏中,输入“Azure 虚拟桌面”,然后选择匹配的服务条目。
选择“主机池”,然后选择要更新的主机池的名称。
选择“RDP 属性”,然后选择“高级”选项卡。
添加额外的 RDP 属性或对分号分隔格式的现有 RDP 属性进行更改,如已显示的默认值。
完成后,选择“保存”以保存更改。 用户需要刷新其资源以接收更改。
若要使用 Azure PowerShell 配置 RDP 属性,请使用以下示例。 请务必将 <placeholder>
值更改为你自己的值。 有关支持的属性和值的完整列表,请参阅 Azure 虚拟桌面支持的 RDP 属性。
在本地设备上运行 PowerShell。
根据要求使用以下示例之一:
若要向主机池添加自定义 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;
用户需要刷新其资源以接收更改。
若要使用 Azure CLI 配置 RDP 属性,请使用以下示例。 请务必将 <placeholder>
值更改为你自己的值。 有关支持的属性和值的完整列表,请参阅 Azure 虚拟桌面支持的 RDP 属性。
在本地设备上运行 Azure CLI。
根据要求使用以下示例之一:
若要向主机池添加自定义 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;
用户需要刷新其资源以接收更改。
相关内容