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:
|
| 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
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 device window's width and height, otherwise Horizon Client uses the default resolution (the device 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
}]
}
}]
}
}
}
}
