要配置某些 Horizon Client 功能，可以使用 common-setting 部分中的设置。editable 属性指定可由用户更改的设置的可用性。下表中的星号表示您可以在可编辑列表中配置的设置。
| 设置 | 说明 |
|---|---|
| editable | 配置 Horizon Client 设置的列表，并指定用户是否可以修改特定的 common settings。通常，每个服务器的策略确定设置的值。您可以在此表中添加标有星号 (*) 的任何客户端功能。 如果 editable 属性中列出的某个设置的值为 False，则该设置将不可用。用户无法更改该设置。用户界面会显示为灰色。要进行更改，系统管理员可以更新服务器设置的策略。 如果某个设置位于 editable 属性列表，并设置为 true，则该设置将在用户界面中可用。用户可以进行更改。
注： 首次使用时，客户端会为服务器应用策略中的任何设置。之后，如果设置可编辑且已由用户更改，则客户端将使用该设置。
|
| allowDataSharing* | 配置数据共享功能。设置此值可启用或停用共享。有效值为 true（启用）和 false（停用）。 |
| allowFileDownload | 配置用户是否可以使用文件传输功能将文件从远程桌面下载到客户端设备。设置此值可启用或阻止文件下载。 有效值为 true（启用）和 false（阻止）。默认值为 true。
注： 要启用使用文件传输功能下载文件，必须在客户端启用
allowFileDownload，并且还要将
Configure file transfer GPO 设置为允许在代理端下载文件。请参阅
《Horizon 远程桌面功能和 GPO》。
|
| allowFileUpload | 配置用户是否可以使用文件传输功能将文件从客户端设备上载到远程桌面。设置此值可启用或阻止文件上载。 有效值为 true（启用）和 false（阻止）。默认值为 true。
注： 要启用使用文件传输功能上载文件，必须在客户端启用
allowFileUpload，并且还要将
Configure file transfer GPO 设置为允许在代理端上载文件。请参阅
《Horizon 远程桌面功能和 GPO》。
|
| autoForwardUSB* | 激活或停用自动 USB 重定向。该值指定是激活还是停用自动 USB 重定向。editable 属性指定用户是否可以在“设置”窗口中更改 USB 自动连接设置。这两个属性的有效值为 true 和 false。 |
| display* | 配置对客户端可用的本地显示器的使用。此设置可以指定客户端窗口的大小。此设置在启动远程桌面时激活。
可用选项：
如果 display 在 editable 属性列表中缺少或设置为false，则此设置将被锁定。如果在 editable 属性中设置为 true，则用户可以更改该设置。 。 |
| enableAdvancedTouch | 激活或停用对高级触摸屏手势的支持，如触摸板、触摸屏、小键盘和鼠标手势中所述。 有效值为 true（激活）和 false（停用）。默认值为 true。 |
| enableAnonymousLogin* | 配置在设置对话框中显示为使用未验证访问匿名登录的未验证访问功能。value 属性指定是启用还是停用该功能。有效值为 true 和 false。 |
| enableFileAssociation | 配置设置文件关联中所述的文件关联功能的激活状态。有效值如下：
如果未配置 enableFileAssociation，则默认将启用文件关联。 |
| enableHighResolution* | 配置高分辨率模式功能。value 属性指定是激活还是停用该功能。editable 属性指定用户是否可以在 Horizon Client 中更改高分辨率模式设置。这两个属性的有效值为 true 和 false。 |
| enableMediaStream | 确定客户端用户是否可以为 Chrome 客户端的浏览器重定向功能和适用于 Microsoft Teams 的媒体优化功能配置摄像头和麦克风权限。有效值如下：
默认值为 true。有关更多信息，请参阅《Horizon 远程桌面功能和 GPO》文档中的配置浏览器重定向和“适用于 Microsoft Teams 的媒体优化”一节。 |
| enableH264 | 指定渲染方法是否使用 H.264 视频模式。客户端启用 H.264 视频模式。有效值为 true 和 false。
注：
仅当您使用缩放比率大于 100% 的常规显示器，并且管理员未停用此功能时，才会在“设置”窗口中显示此选项。 |
| enableRTAVH264Codec | 为实时音频-视频启用或停用 H.264 编解码器。有效值为 true（启用 H.264）和 false（停用 H.264）。 默认值为 true。 有关更多信息，请参阅将实时音频-视频功能用于网络摄像头、麦克风和扬声器。 |
| forcePrivateMode | 为 Horizon Cloud on Azure next-gen 启用隐私模式。使用此设置可强制为最终用户启用隐私模式。如果启用此设置，用户必须进行身份验证才能登录。Horizon Client 关闭或从当前服务器断开连接后，用户会被定向到浏览器注销页面。此设置在未配置时处于禁用状态 |
| enableNetworkIndicator | 按照检测不稳定的网络连接中所述激活或停用网络通知功能。有效值为 true（功能已激活）和 false（功能已停用）。 将值设置为 false 会从设置窗口中移除禁止显示网络状态选项。 默认值为 true。 |
enableLogoutTriggeredQuit |
在注销时触发客户端关闭。如果启用此策略选项，则会在用户成功注销时触发客户端关闭。 此选项接受类型为 |
enableDisconnectionTriggeredQuit |
在与最后一个活动桌面或应用程序断开连接时，触发客户端关闭。如果启用此策略选项，则会在与最后一个活动桌面或应用程序断开连接时触发客户端关闭。 此选项接受类型为 |
| enableScreenSharing* | 允许或禁止用户在使用已发布的应用程序时共享其本地屏幕的内容。有效值为 true（允许）和 false（禁止）。 editable 属性指定用户是否可以从“设置”窗口中控制其屏幕共享权限。 |
| enableWebRTCRedirection* | 为基于 WebRTC 的应用程序激活或停用媒体优化功能。 如果激活，此功能可优化远程桌面内基于 WebRTC 的应用程序的音频、视频和屏幕共享流。此功能可改善用户在虚拟会议和电话会议期间的整体音频-视觉体验。 有效值为 true（功能已激活）和 false（功能已停用）。 editable 属性指定用户是否可以从“设置”窗口控制 WebRTC 媒体优化的激活状态。 |
| enableWindowsKey* | 激活或停用远程桌面的 Windows 密钥。此值指定是激活还是停用该功能。editable 属性指定用户是否可以在 Horizon Client 中更改为桌面启用 Windows 键设置。这两个属性的有效值为 true 和 false。 |
| hardwareAccelerationOption | 为实时音频-视频配置客户端 GPU 硬件加速。有关更多信息，请参阅将实时音频-视频功能用于网络摄像头、麦克风和扬声器。 有效值如下：
|
| hideSecondaryServer | 配置 Horizon Client 是同时显示主服务器主机名和辅助服务器主机名的服务器图标，还是仅显示主服务器主机名的服务器图标。 有效值为 true（仅显示主要主机名的单个图标）和 false。
默认值为 true。 |
| ignoreCertErrors | 配置浏览器重定向功能是否可以打开包含 SSL 或安全证书错误的页面。有效值如下：
默认值为 false。有关更多信息，请参阅配置浏览器重定向。 |
| networkStateConfig | 指定 Horizon Client 用于计算网络质量评分并确定网络稳定性的阈值参数。有关 Horizon Client 如何使用这些参数的详细信息，请参阅检测不稳定的网络连接。 此设置包括以下属性：
|
| powerSetting | 防止设备因远程会话中用户处于不活动状态而进入睡眠状态。默认情况下，Chrome 设备会在 10 分钟后进入睡眠状态。配置 powerSetting 后，在最后一个远程会话结束之后，设备才会进入睡眠状态。 keepAwakeLevel 属性指定电源策略的级别。对于 keepAwakeLevel 属性，以下值有效：
|
| splitUSB | 指定 USB 设备的拆分重定向行为，如拆分复合 USB 设备中所述。 此设置包括以下属性：
使用此设置时，将忽略等效的代理组策略设置（拆分 Vid/Pid 设备）。 |
| urlFiltering | 为客户端配置 URL 内容重定向规则。URL 内容重定向功能也需要代理端配置。有关更多信息，请参阅使用 URL 内容重定向的要求以及《Horizon 远程桌面功能和 GPO》文档中的“配置 URL 内容重定向”。
注： 必须重新启动
Horizon Client，所有修改后的规则才会生效。
注： 在连接服务器实例上使用
vdmutil 命令行界面配置的 URL 内容重定向规则优先于使用
urlFiltering 设置配置的 URL 内容重定向规则。
urlFiltering 设置具有一个属性 protocols，可设置为具有以下属性的对象数组：
注： 重定向 URL 的范围可能因对
agentRules 使用的规则语法而异。
|
| useAssetIdReplaceMachineName | 配置如何将客户端资产 ID（物理计算机名称）传递到相应的 Horizon 环境变量。有关更多信息，请参阅 VMware 知识库 (KB) 文章 92513。 有效值如下：
默认值为 false。 |
| ws1WebviewMode | 配置用户是否可以在作为受管应用程序（例如由 Unified Access Gateway 和 Workspace ONE 管理的应用程序）运行的 Horizon Client 中进行身份验证。有效值如下：
默认值为 secure-webview。 |
以下 JSON 配置文件示例显示了 editable 属性的一些常见设置和使用情况。此示例显示了可最大程度地提高性能和效率以获得最佳用户体验的建议设置。
{
"broker_list": {
"Value": {
"settings": {
"server-list": [
{
"server": "viewserver0.mydomain.com",
"default": true,
"description": "View Server 0",
"username": "User0",
"domain": "TestDomain0"
}
],
"common-setting": {
"allowDataSharing": true,
"enableAdvancedTouch": true,
"enableAnonymousLogin": false,
"allowFileDownload": true,
"allowFileUpload": true,
"enableWindowsKey": true,
"enableFileAssociation": false,
"enableH264": true,
"enableRTAVH264Codec": true,
"forcePrivateMode": true,
"hardwareAccelerationOption": "no-preference",
"ignoreCertErrors": false,
"ws1WebviewMode": "secure-webview",
"autoForwardUSB": true,
"display": "useAllMonitor",
"enableHighResolution": false,
"useAssetIdReplaceMachineName": false,
"splitUSB": {
"allowList": [
{
"device": "0554:1001",
"excludedInterface": [
"00",
"01",
"02"
]
}
]
},
"hideSecondaryServer": true,
"enableAdvancedTouch": false,
"enableMediaStream": false,
"enableScreenSharing": true,
"enableNetworkIndicator": true,
"enableLogoutTriggeredQuit": true,
"enableDisconnectionTriggeredQuit": true,
}
"networkStateConfig": {
"networkStateTcpRttMSLow": 2,
"networkStateTcpRttMSHigh": 400,
"networkStateQualityScoreTcpThresholdGood": 85,
"networkStateQualityScoreTcpThresholdPoor": 40,
"networkStateRttCheckPeriodMs": 15000
},
"urlFiltering": {
"protocols": [
{
"brokerHostname": "10.117.24.28",
"protocol": "http",
"remoteItem": "win2022_RDSH",
"agentRules": ".*example1.com"
},
{
"brokerHostname": "10.117.161.109",
"protocol": "https",
"remoteItem": "win10_VDI",
"agentRules": ".*example2.com"
}
]
},
"editable": {
"allowDataSharing": true,
"enableAnonymousLogin": true,
"enableHighResolution": true,
"autoForwardUSB": true,
"enableH264": true,
"enableWebRTCRedirection": true,
"display": true,
"enableScreenSharing": true
}
}
}
}
}
}
