你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

自定义主机池的远程桌面协议 (RDP) 属性

  • 项目

重要

本教程的内容适用于包含 Azure 资源管理器 Azure 虚拟桌面对象的 Azure 虚拟桌面。 如果你使用的是不包含 Azure 资源管理器对象的 Azure 虚拟桌面（经典），请参阅此文。

可以自定义主机池的远程桌面协议 (RDP) 属性（例如多监视器体验和音频重定向），以便根据用户的需要为用户提供最佳体验。 如果你想要更改默认的 RDP 文件属性，可以通过使用 Azure 门户或在 Update-AzWvdHostPool cmdlet 中使用 -CustomRdpProperty 参数，在 Azure 虚拟桌面中自定义 RDP 属性。

有关支持的属性及其默认值的完整列表，请参阅 Azure 虚拟桌面支持的 RDP 属性。

默认 RDP 文件属性

RDP 文件默认具有以下属性：

RDP 属性 对于桌面和 RemoteApp
多监视器模式 已启用
已启用重定向 驱动器、剪贴板、打印机、COM 端口、智能卡、设备、USB 设备存储和 WebAuthn
远程音频模式 本地播放
VideoPlayback 已启用
EnableCredssp 已启用

重要

  • 仅为桌面应用程序组启用多监视器模式，对于 RemoteApp 应用程序组将忽略此模式。

  • 所有默认 RDP 文件属性将在 Azure 门户中公开。

  • null CustomRdpProperty 字段会将所有默认的 RDP 属性应用到主机池。 空 CustomRdpProperty 字段不会将任何默认的 RDP 属性应用到主机池。

  • 如果还使用组策略对象 (GPO) 配置设备重定向设置，则 GPO 中的设置将替代在主机池上指定的 RDP 属性。

先决条件

在开始之前，请按照设置 Azure 虚拟桌面 PowerShell 模块中的说明设置 PowerShell 模块并登录到 Azure。

在 Azure 门户中配置 RDP 属性

若要在 Azure 门户中配置 RDP 属性，请执行以下操作：

  1. 登录 Azure 门户。
  2. 在搜索栏中输入“Azure 虚拟桌面”。
  3. 在“服务”下，选择“Azure 虚拟桌面”。
  4. 在“Azure 虚拟桌面”页上，在屏幕左侧的菜单中，选择“主机池”。
  5. 选择要更新的主机池的名称。
  6. 在屏幕左侧的菜单中选择“RDP 属性”。
  7. 设置所需的属性。
    • 或者，你可以打开“高级”选项卡，并以分号分隔的格式添加 RDP 属性，如以下部分中的 PowerShell 示例所示。
  8. 完成后，选择“保存”以保存更改。

后续部分将介绍如何在 PowerShell 中手动编辑自定义 RDP 属性。

添加或编辑单个自定义 RDP 属性

若要添加或编辑单个自定义 RDP 属性，请运行以下 PowerShell cmdlet：

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty <property>

注意

Azure 虚拟桌面服务不接受转义字符（例如分号或冒号）作为有效的自定义 RDP 属性名称。

若要检查刚运行的 cmdlet 是否已更新属性，请运行以下 cmdlet：

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

例如，如果要在名为 0301HP 的主机池上检查“audiocapturemode”属性，请输入以下 cmdlet：

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;

添加或编辑多个自定义 RDP 属性

若要添加或编辑多个自定义 RDP 属性，请运行以下 PowerShell cmdlet，方法是以分号分隔的字符串提供自定义 RDP 属性：

$properties="<property1>;<property2>;<property3>"
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty $properties

注意

Azure 虚拟桌面服务不接受转义字符（例如分号或冒号）作为有效的自定义 RDP 属性名称。

可以通过运行以下 cmdlet 进行检查，确保已添加 RDP 属性：

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

根据前面的 cmdlet 示例，如果在 0301HP 主机池上设置了多个 RDP 属性，则 cmdlet 将如下所示：

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;

重置所有自定义 RDP 属性

可以按照添加或编辑单个自定义 RDP 属性中的说明将各个自定义 RDP 属性重置为其默认值。 还可以通过运行以下 PowerShell cmdlet 重置主机池的所有自定义 RDP 属性：

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty ""

若要确保已成功删除设置，请输入以下 cmdlet：

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <CustomRDPpropertystring>

后续步骤

现在你已自定义给定主机池的 RDP 属性，因此可以登录到 Azure 虚拟桌面客户端，将其作为用户会话的一部分进行测试。 接下来的两篇操作指南将会介绍如何使用所选的客户端连接到会话：