You can use settings in the server-list section to configure certain features for specific servers. 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.

Setting Description

autoForwardUSBPolicy

Note: To configure a global policy that applies to all virtual desktops brokered by the server, set the desktop value to "HorizonAutoUsbAll". The global policy overrides all other USB redirection policies configured for specific desktops.
Specifies the default behavior of automatic USB redirection for client USB devices and virtual desktops brokered by the server. For each policy, you configure a data array with the following properties:
  • desktop specifies the name of the virtual desktop to which the policy applies. If multiple policies are configured with the same desktop value, the policy listed last in the array takes effect.
  • autoConnectAllOnStart specifies whether to redirect all available USB devices when the desktop session starts. Valid values are true and false.
  • autoConnectAllOnInsert specifies whether to redirect all USB devices when they are inserted in the client system. Valid values are true and false.
  • policy allows you to configure the redirection behavior for specific USB devices. For each device policy, you configure a data object with the following properties:
    • device specifies the identity of the USB device. Valid values take the format <vid>:<pid>, where <vid> specifies the vendor ID and <pid> specifies the product ID of the device.
    • autoConnectOnStart specifies whether to redirect the device when the desktop session starts. Valid values are true and false.
    • autoConnectOnInsert specifies whether to redirect the device when it is inserted in the client system. Valid values are true and false.
    Note: The desktop-level policies ( autoConnectAllOnStart, autoConnectAllOnInsert) take priority over device-specific policies.
editable Configures a list that specifies whether a user can modify certain settings. Generally, the policy from each server determines the value of the settings.

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

If a setting is in the editable property 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. After that, if the setting is editable and has been changed by the user, the client uses that setting.
enableAutoForwardUSB* Activates or deactivates automatic USB redirection for virtual desktops. The value specifies whether automatic USB redirection is activated or deactivated. The editable property specifies whether users can change the USB auto-connect settings in Horizon Client. Valid values for both properties are true and false.
enableHighResolution* Configures the high resolution mode feature. The value property specifies whether the feature is activated or deactivated. The editable property specifies whether users can change the High Resolution Mode setting in Horizon Client. Valid values for both properties are true and false.
enableMultiMonitor* Configures the multi-monitor feature. The value property specifies whether the feature is activated or deactivated. Valid values are true and false.

If the value property is enabled, the Display setting in Horizon Client is affected as follows:

  • If the user has already set a specific display on the device, the Display setting is set to Use Selected Display.
  • If the user has never set a specific display on the device, the Display setting is set to Use All Displays.
If the value property is deactivated, the Display setting is set to Use Single Display.
Note: The priority of this setting enableMultiMonitor in server features is higher than the priority of setting enableMultiMonitor in client features, but lower than the setting display in client features.
enableWindowsKey* Activates or deactivates the Windows key for remote desktops. The value specifies whether the feature is activated or deactivated. The editable property specifies whether users can change the Enable Windows Key for Desktops setting in Horizon Client. Valid values for both properties are true and false.
resolution Configures the screen resolution. The width property specifies the screen width and the height property specifies the screen height. Both values should be less than or equal to the Chromebook window's width and height, otherwise Horizon Client uses the default resolution (the Chromebook window's width and height).
timezoneSync* Configures the time zone for remote desktops and published applications. The isSync property specifies whether to set the time zone automatically. The editable property specifies whether users can change the Set Time Zone Automatically setting in Horizon Client. Valid values for both properties are true and false. If you set isSync to false, you can set the time zone manually by specifying the timezone property.
Note: When you set the isSync property to true, the client's time zone is always consistent with the host operating system's time zone, regardless of the value of the timezone property.
usbAllowList Specifies the USB devices that are redirected. If a device is not listed, it is blocked. Use the vid property to specify the vendor ID and the pid property to specify the product ID of each device.

When this setting is used, the equivalent agent group policy setting (Include Vid/Pid Device) is ignored.

usbBlockList Specifies the USB devices that are blocked from redirection. Use the vid property to specify the vendor ID and the pid property to specify the product ID of each device.

When this setting is used, the equivalent agent group policy setting (Exclude Vid/Pid Device) is ignored.

The usbBlockList setting has higher priority than the usbAllowList setting, which means if a device is in both lists, it is blocked.

The following JSON configuration file example shows the server settings.

{
  "broker_list": {
    "Value": {
      "settings": {
         "server-list": [{
            "server": "viewserver0.mydomain.com",
            "default": true,
            "description": "View Server 0", 
            "username": "User0",
            "domain": "TestDomain0",
            "settings": {
               "enableHighResolution": false,
               "enableMultiMonitor": false,
               "enableWindowsKey": true,
               "timezoneSync": {
                   "isSync": false,
                   "timezone": "-00:00"
               },
               "resolution": {
                 "width": 600,
                 "height": 800
               },
               "enableAutoForwardUSB": true,
               "autoForwardUSBPolicy": [{
                  "desktop": "win10",
                  "autoConnectAllOnStart": true,
                  "autoConnectAllOnInsert": false,
                  "policy":[{
                     "device": "0001:0002",
                     "autoConnectOnStart": false,
                     "autoConnectOnInsert": false
                  },{
                     "device": "1001:1002",
                     "autoConnectOnStart": true,
                     "autoConnectOnInsert": false
                  }]
               },{
                  "desktop": "win11",
                  "autoConnectAllOnStart": false,
                  "autoConnectAllOnInsert": false,
                  "policy":[{
                     "device": "1001:1002",
                     "autoConnectOnStart": false,
                     "autoConnectOnInsert": true
                  }]
               }],
               "editable": {
                  "enableAutoForwardUSB": true,
                  "enableHighResolution": true,
                  "enableMultiMonitor": false,
                  "enableWindowsKey": false,
                  "timezoneSync": false
               },
               "usbAllowList":[{
                  "vid": 1111,
                  "pid": 2222
               },{
                  "vid": 1112,
                  "pid": 2223
               }],
               "usbBlockList":[{
                  "vid": 2222,
                  "pid": 3333
                },{
                  "vid": 2223,
                  "pid": 3334
                }]
              }
           }]
        }
    }
  }
}