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.
| 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:
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:
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:
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.
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:
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 Chrome device goes to sleep after 10 minutes. When you configure powerSetting, the device 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:
|
| 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:
Note: The range of redirected URLs can differ based on the rule syntax that you use for
agentRules.
|
| useAssetIdReplaceMachineName | Configures how to pass the client asset ID (the physical computer name) to a corresponding Horizon environmental variable. For more information, see VMware Knowledge Base (KB) article 92513. Valid values are as follows:
The default value is false. |
| 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:
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,
"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"
}
]
}
}
}
}
}
}
