To configure certain Horizon Client features, you can use settings in the common-setting section. The editable property specifies the availability of settings to change by the user. An asterisk in the following table indicates settings you can configure in the editable list.

Note: To ensure that modified settings take effect, users must restart Horizon Client.
Setting Description
editable Configures a list of Horizon Client settings and specifies whether a user can modify certain common settings. In general, the policy from each server determines value of the settings. You can add any client feature in this table marked with an asterisk (*).

If the value for a setting listed in the editable property is false, that setting is unavailable. The user cannot change that setting. The user interface appears gray. To make changes, the system administrator can update the policy set by the server.

If a setting is in editable property list and set to true, that setting is available in the user interface. The user can make a change.

Note: On first use, the client applies any settings in the policy for server. After that, if the setting is editable and has been changed by the user, the client uses that setting.
allowDataSharing* Configures the data sharing feature. Set the value to enable or deactivate sharing. Valid values are true (enable) and false (deactivate).
allowFileDownload

Configures whether users can download files from a remote desktop to the client device using the file transfer feature. Set the value to enable or block file downloading.

Valid values are true (enable) and false (block). The default value is true.

Note: To enable file downloading with the file transfer feature, you must enable allowFileDownload on the client side and also set the Configure file transfer GPO setting to allow file downloading on the agent side. See Horizon Remote Desktop Features and GPOs.
allowFileUpload

Configures whether users can upload files to a remote desktop from the client device using the file transfer feature. Set the value to enable or block file uploading.

Valid values are true (enable) and false (block). The default value is true.

Note: To enable file uploading with the file transfer feature, you must enable allowFileUpload on the client side and also set the Configure file transfer GPO setting to allow file uploading on the agent side. See Horizon Remote Desktop Features and GPOs.
display* Configures the use of local monitors available to the client. This setting can specify the size of the client window. This setting activates on launch of a remote desktop.
Available options:
  • multipleMonitors: render in all available monitors. You must set enableMultiMonitor property to true.
  • singleMonitor: render in one monitor using the default window size.
  • singleMonitorFullscreen: render in a one monitor using the full screen.
  • singleMonitorSmallWindow: render in one monitor using a small window size (640x480)
  • singleMonitorLargeWindow: render in one monitor using the large window size (1680x983).
  • {width:mmm, height:nnn}: render in one monitor using the size you provide. (mmmxnnn)
This setting is locked if display is missing from the list in the editable property or set to false. If set to true in the editable property, the user can change the setting.
Note: The display setting takes precedence enableMultiMultiMonitor. The enableMultiMonitor setting in server features takes precedence over the enableMultiMonitor setting in client features. However, the display setting in client features takes precedence over the enableMultiMonitor setting in server features.
.
enableAnonymousLogin* Configures the Unauthenticated Access feature that appears as Log in anonymously using Unauthenticated Access in the settings dialog box. The value property specifies whether the feature is enabled or deactivated. Valid values are true and false.
enableFileAssociation

Configures the activation state of the File Association feature described in Set File Association. Valid values are as follows:

  • true: File Association is enabled.
  • false: File Association is deactivated. Users can still right-click a local file and select VMware Horizon Client for Chrome, but a warning message appears instead of a list of available apps.

If enableFileAssociation is not configured, File Association is enabled by default.

enableMediaStream

Determines whether client users can configure camera and microphone permissions for the Browser Redirection feature and the Media Optimization for Microsoft Teams feature for the Chrome client. Valid values are as follows:

  • true: Client users can configure settings and respond to prompts that allow or deny remote browsers access to client cameras and microphones during Browser Redirection.
  • false: All settings and prompts related to camera and microphone permissions are hidden from client users. Users cannot configure these permissions. Remote browsers are automatically denied access to client cameras and microphones during Browser Redirection.

The default value is true. For more information, see Configure Browser Redirection and the "Media Optimization for Microsoft Teams" section in the Horizon Remote Desktop Features and GPOs document.

enableMultiMonitor* Configures the Multi-Monitor feature. Use the value property to specify whether the feature is turned on or off. Valid values are true and false.
hideSecondaryServer

Configures whether Horizon Client displays a server icon for both the primary and secondary server host names, or for the primary server host name only.

Valid values are true (display a single icon for the primary host name only) and false.

  • When set to true, Horizon Client displays an icon for the primary host name only.
  • When set to false, Horizon Client displays a server icon for both the primary and secondary server host names. This setting can result in the display of two icons for the same server. For example, in the case where a load balancer functions as the primary host and Unified Access Gateway (UAG) functions as the secondary host, Horizon Client displays an icon for the load balancer host name and a duplicate icon for the UAG host name.

The default value is true.

ignoreCertErrors

Configures whether the Browser Redirection feature opens pages that contain SSL or security certificate errors. Valid values are as follows:

  • false: The Browser Redirection feature does not open pages with SSL or certificate errors. The pages are not redirected and Horizon Client displays a message about the SSL or certificate error.
  • true: The Browser Redirection feature proceeds to open pages with SSL or certificate errors. The errors are ignored and the pages are redirected.

The default value is false. For more information, see Configure Browser Redirection.

powerSetting Prevents the device from going to sleep in response to user inactivity in a remote session. By default, the Chromebook goes to sleep after 10 minutes. When you configure powerSetting, the Chromebook does not go to sleep until after the last remote session ends.

The keepAwakeLevel property specifies the level of the power policy. The following values are valid for the keepAwakeLevel property:

  • system: prevents the system from sleeping in response to user inactivity. This value is the default.
  • display: prevents the display from being turned off or dimmed, or the system from sleeping, in response to user inactivity.
urlFiltering

Configures URL Content Redirection rules for the client. The URL Content Redirection feature also requires agent-side configuration. For more information, see Requirements for Using URL Content Redirection and "Configuring URL Content Redirection" in the Horizon Remote Desktop Features and GPOs document.

Note: You must restart Horizon Client for any modified rules to take effect.
Note: The URL Content Redirection rules configured using the vdmutil command-line interface on a Connection Server instance take priority over the URL Content Redirection configured using the urlFiltering setting.

The urlFiltering setting has one property, protocols, which is set to an object array with the following properties:

  • brokerHostname: IP address or fully qualified domain name (FQDN) of the Connection Server host to use when redirecting URLs.
  • protocol: URL protocol to be redirected.
  • remoteItem: display name of the remote desktop or application pool that can handle the URLs specified for agentRules.
  • agentRules: URLs that are redirected to the remote desktop or application specified for remoteItem. For example, if you set agentRules to .*mycompany.com, all URLs that include the string mycompany.com are redirected to the remote desktop or application.
Note: The range of redirected URLs can differ based on the rule syntax that you use for agentRules.
  • The rule syntax .*mycompany.com supports the redirection of all URLs that contain the string mycompany.com, including http://mycompany.com.
  • The rule syntax .*.mycompany.com supports the redirection of all URLs that contain the string .mycompany.com. However, it does not support redirection of the root URL. For example, http://mycompany.com is not redirected.
ws1WebviewMode

Configures whether users can authenticate into Horizon Client running as a managed app, such as an app managed by Unified Access Gateway and Workspace ONE. Valid values are as follows:

  • secure-webview: allows users to authenticate into Horizon Client as a managed app, and clears cache and cookies after authentication is complete.
  • persistent-webview: allows users to authenticate into Horizon Client as a managed app, but does not clear cache and cookies after authentication is complete. This value allows the storage of authentication information.
  • browser: requires the opening of a browser window for user authentication. This value prevents Horizon Client from running as a managed app.

The default value is secure-webview.

The following example of a JSON configuration file shows the common settings and usage of the editable property.

{
  "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,
          "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"
              }
            ]
          }
        }
      }
    }
  }
}