要配置某些 Horizon Client 功能,可以使用 common-setting 部分中的设置。editable 属性指定可由用户更改的设置的可用性。下表中的星号表示您可以在可编辑列表中配置的设置。

注: 要确保修改后的设置生效,用户必须重新启动 Horizon Client
设置 说明
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》
display* 配置对客户端可用的本地显示器的使用。此设置可以指定客户端窗口的大小。此设置在启动远程桌面时激活。
可用选项:
  • multipleMonitors:在所有可用的显示器中呈现。必须将 enableMultiMonitor 属性设置为 true
  • singleMonitor:使用默认窗口大小在一个显示器中呈现。
  • singleMonitorFullscreen:使用全屏在一个显示器中呈现。
  • singleMonitorSmallWindow:使用小窗口大小 (640 x 480) 在一个显示器中呈现
  • singleMonitorLargeWindow:使用大窗口大小 (1680 x 983) 在一个显示器中呈现。
  • {width:mmm, height:nnn}:使用您提供的大小在一个显示器中呈现。(mmm x nnn)
如果 displayeditable 属性列表中缺少或设置为 false,则此设置将被锁定。如果在 editable 属性中设置为 true,则用户可以更改该设置。
注: display 设置优先于 enableMultiMultiMonitor。服务器功能中的 enableMultiMonitor 设置优先于客户端功能中的 enableMultiMonitor 设置。但是,客户端功能中的 display 设置优先于服务器功能中的 enableMultiMonitor 设置。
enableAnonymousLogin* 配置在设置对话框中显示为使用未验证访问匿名登录的未验证访问功能。value 属性指定是启用还是停用该功能。有效值为 truefalse
enableFileAssociation

配置设置文件关联中所述的文件关联功能的激活状态。有效值如下:

  • true:启用文件关联。
  • false:停用文件关联。用户仍然可以右键单击本地文件并选择适用于 Chrome 的 VMware Horizon Client,但会显示一条警告消息,而不是可用应用程序列表。

如果未配置 enableFileAssociation,则默认将启用文件关联。

enableMediaStream

确定客户端用户是否可以为 Chrome 客户端的浏览器重定向功能和适用于 Microsoft Teams 的媒体优化功能配置摄像头和麦克风权限。有效值如下:

  • true:客户端用户可以配置这些设置,并且可以在浏览器重定向期间响应允许还是拒绝远程浏览器访问客户端摄像头和麦克风的提示。
  • false:对客户端用户隐藏与摄像头和麦克风权限相关的所有设置和提示。用户无法配置这些权限。在浏览器重定向期间,将自动拒绝远程浏览器对客户端摄像头和麦克风的访问。

默认值为 true。有关更多信息,请参阅《Horizon 远程桌面功能和 GPO》文档中的配置浏览器重定向和“适用于 Microsoft Teams 的媒体优化”一节。

enableMultiMonitor* 配置多显示器功能。使用 value 属性可指定是打开还是关闭该功能。有效值为 truefalse
hideSecondaryServer

配置 Horizon Client 是同时显示主服务器主机名和辅助服务器主机名的服务器图标,还是仅显示主服务器主机名的服务器图标。

有效值为 true(仅显示主要主机名的单个图标)和 false

  • 设置为 true 时,Horizon Client 仅显示主要主机名的图标。
  • 设置为 false 时,Horizon Client 显示主服务器主机名和辅助服务器主机名的图标。此设置可能会导致为同一服务器显示两个图标。例如,如果负载均衡器用作主要主机,Unified Access Gateway (UAG) 用作辅助主机,Horizon Client 会显示负载均衡器主机名的图标和 UAG 主机名的重复图标。

默认值为 true

ignoreCertErrors

配置浏览器重定向功能是否可以打开包含 SSL 或安全证书错误的页面。有效值如下:

  • false:浏览器重定向功能无法打开包含 SSL 或证书错误的页面。将不会重定向此类页面,并且 Horizon Client 会显示有关 SSL 或证书错误的消息。
  • true:浏览器重定向功能继续打开包含 SSL 或证书错误的页面。将忽略这些错误并重定向此类页面。

默认值为 false。有关更多信息,请参阅配置浏览器重定向

powerSetting 防止设备因远程会话中用户处于不活动状态而进入睡眠状态。默认情况下,Chrome 设备会在 10 分钟后进入睡眠状态。配置 powerSetting 后,在最后一个远程会话结束之后,设备才会进入睡眠状态。

keepAwakeLevel 属性指定电源策略的级别。对于 keepAwakeLevel 属性,以下值有效:

  • system:阻止系统因用户处于不活动状态而进入睡眠状态。该值是默认值。
  • display:阻止显示器因用户处于不活动状态而关闭或灰显,或者阻止系统进入睡眠状态。
urlFiltering

为客户端配置 URL 内容重定向规则。URL 内容重定向功能也需要代理端配置。有关更多信息,请参阅使用 URL 内容重定向的要求以及《Horizon 远程桌面功能和 GPO》文档中的“配置 URL 内容重定向”。

注: 必须重新启动 Horizon Client,所有修改后的规则才会生效。
注: 在连接服务器实例上使用 vdmutil 命令行界面配置的 URL 内容重定向规则优先于使用 urlFiltering 设置配置的 URL 内容重定向规则。

urlFiltering 设置具有一个属性 protocols,可设置为具有以下属性的对象数组:

  • brokerHostname:重定向 URL 时要使用的连接服务器主机的 IP 地址或完全限定域名 (Fully Qualified Domain Name, FQDN)。
  • protocol:要重定向的 URL 协议。
  • remoteItem:可对为 agentRules 指定的 URL 进行处理的远程桌面或应用程序池的显示名称。
  • agentRules:重定向到为 remoteItem 指定的远程桌面或应用程序的 URL。例如,如果将 agentRules 设置为 .*mycompany.com,则所有包含字符串 mycompany.com 的 URL 都会重定向到远程桌面或应用程序。
注: 重定向 URL 的范围可能因对 agentRules 使用的规则语法而异。
  • 规则语法 .*mycompany.com 支持对所有包含字符串 mycompany.com 的 URL 进行重定向,包括 http://mycompany.com
  • 规则语法 .*.mycompany.com 支持对所有包含字符串 .mycompany.com 的 URL 进行重定向。但是,它不支持重定向根 URL。例如,不会重定向 http://mycompany.com
useAssetIdReplaceMachineName

配置如何将客户端资产 ID(物理计算机名称)传递到相应的 Horizon 环境变量。有关更多信息,请参阅 VMware 知识库 (KB) 文章 92513

有效值如下:

  • false:资产 ID 将传递到 ViewClient_Asset_ID 环境变量。
  • true:资产 ID 将传递到 ViewClient_Machine_Name 环境变量。

默认值为 false

ws1WebviewMode

配置用户是否可以在作为受管应用程序(例如由 Unified Access GatewayWorkspace ONE 管理的应用程序)运行的 Horizon Client 中进行身份验证。有效值如下:

  • Secure-webview:允许用户在作为受管应用程序的 Horizon Client 中进行身份验证,并在身份验证完成后清除缓存和 cookie。
  • Persistent-webview:允许用户在作为受管应用程序的 Horizon Client 中进行身份验证,但在身份验证完成后不会清除缓存和 cookie。此值允许存储身份验证信息。
  • browser:需要打开浏览器窗口以进行用户身份验证。此值会阻止 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": false,
          "allowFileDownload": true,
          "allowFileUpload": false,
          "enableAnonymousLogin": true,
          "enableMultiMonitor": false,
          "enableMediaStream": true,
          "hideSecondaryServer": true,
          "ignoreCertErrors": false,
          "enableFileAssociation": false,
          "useAssetIdReplaceMachineName": true,
          "ws1WebviewMode": "secure-webview",
          "display": "{width:400, height: 500}",
          "editable": {
            "allowDataSharing": true,
            "enableAnonymousLogin": false,
            "enableMultiMonitor": false
          },
          "powerSetting": {
            "keepAwakeLevel": "display"
          },
          "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"
              }
            ]
          }
        }
      }
    }
  }
}