USB Settings for Client GPOs

You can define USB policy settings for both the agent and Horizon Client for Windows. On connection, Horizon Client downloads the USB policy settings from the agent and uses them in conjunction with the Horizon Client USB policy settings to decide which devices it will allow to be available for redirection from the host machine.

The following table describes each policy setting for splitting composite USB in the Horizon Client Configuration ADM template file. The settings apply at computer level. Horizon Client preferentially reads the settings from the GPO at computer level, and otherwise from the registry at HKLM\Software\Policies\VMware, Inc.\VMware VDM\Client\USB. For a description of how View applies the policies for splitting composite USB devices, see the topics about using policies to control USB redirection, in the Setting Up Desktop and Application Pools in View document.

Table 1. Horizon Client Configuration Template: USB Splitting Settings

Setting	Properties
Allow Auto Device Splitting	Allow the automatic splitting of composite USB devices. The default value is undefined, which equates to false.
Exclude Vid/Pid Device From Split	Excludes a composite USB device specified by vendor and product IDs from splitting. The format of the setting is vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... You must specify ID numbers in hexadecimal. You can use the wildcard character (*) in place of individual digits in an ID. For example: vid-0781_pid-55** The default value is undefined.
Split Vid/Pid Device	Treats the components of a composite USB device specified by vendor and product IDs as separate devices. The format of the setting is vid-xxxx_pid-yyyy(exintf:zz[;exintf:ww ]) You can use the exintf keyword to exclude components from redirection by specifying their interface number. You must specify ID numbers in hexadecimal, and interface numbers in decimal including any leading zero. You can use the wildcard character (*) in place of individual digits in an ID. For example: vid-0781_pid-554c(exintf:01;exintf:02) Note: View does not automatically include the components that you have not explicitly excluded. You must specify a filter policy such as Include Vid/Pid Device to include those components. The default value is undefined.

The following table describes each policy setting for filtering USB devices in the Horizon Client Configuration ADM template file. The settings apply at computer level. Horizon Client preferentially reads the settings from the GPO at computer level, and otherwise from the registry at HKLM\Software\Policies\VMware, Inc.\VMware VDM\Client\USB. For a description of how View applies the policies for filtering USB devices, see the topics about configuring filter policy settings for USB redirection, in the Setting Up Desktop and Application Pools in View document.

Table 2. Horizon Client Configuration Template: USB Filtering Settings

Setting	Properties
Allow Audio Input Devices	Allows audio input devices to be redirected. The default value is undefined, which equates to true.
Allow Audio Output Devices	Allows audio output devices to be redirected. The default value is undefined, which equates to false.
Allow HIDBootable	Allows input devices other than keyboards or mice that are available at boot time (also known as hid-bootable devices) to be redirected. The default value is undefined, which equates to true.
Allow Device Descriptor Failsafe Behavior	Allows devices to be redirected even if the Horizon Client fails to get the config/device descriptors. To allow a device even if it fails the config/desc, include it in the Include filters, such IncludeVidPid or IncludePath. The default value is undefined, which equates to false.
Allow Other Input Devices	Allows input devices other than hid-bootable devices or keyboards with integrated pointing devices to be redirected. The default value is undefined, which equates to true.
Allow Keyboard and Mouse Devices	Allows keyboards with integrated pointing devices (such as a mouse, trackball, or touch pad) to be redirected. The default value is undefined, which equates to false.
Allow Smart Cards	Allows smart-card devices to be redirected. The default value is undefined, which equates to false.
Allow Video Devices	Allows video devices to be redirected. The default value is undefined, which equates to true.
Disable Remote Configuration	Disables the use of agent settings when performing USB device filtering. The default value is undefined, which equates to false.
Exclude All Devices	Excludes all USB devices from being redirected. If set to true, you can use other policy settings to allow specific devices or families of devices to be redirected. If set to false, you can use other policy settings to prevent specific devices or families of devices from being redirected. If you set the value of Exclude All Devices to true on the agent, and this setting is passed to Horizon Client, the agent setting overrides the Horizon Client setting. The default value is undefined, which equates to false.
Exclude Device Family	Excludes families of devices from being redirected. The format of the setting is family_name_1[;family_name_2]... For example: bluetooth;smart-card If you have enabled automatic device splitting, View examines the device family of each interface of a composite USB device to decide which interfaces should be excluded. If you have disabled automatic device splitting, View examines the device family of the whole composite USB device. The default value is undefined.
Exclude Vid/Pid Device	Excludes devices with specified vendor and product IDs from being redirected. The format of the setting is vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... You must specify ID numbers in hexadecimal. You can use the wildcard character (*) in place of individual digits in an ID. For example: vid-0781_pid-****;vid-0561_pid-554c The default value is undefined.
Exclude Path	Exclude devices at specified hub or port paths from being redirected. The format of the setting is bus-x1[/y1].../port-z1[;bus-x2[/y2].../port-z2]... You must specify bus and port numbers in hexadecimal. You cannot use the wildcard character in paths. For example: bus-1/2/3_port-02;bus-1/1/1/4_port-ff The default value is undefined.
Include Device Family	Includes families of devices that can be redirected. The format of the setting is family_name_1[;family_name_2]... For example: storage The default value is undefined.
Include Path	Include devices at a specified hub or port paths that can be redirected. The format of the setting is bus-x1[/y1].../port-z1[;bus-x2[/y2].../port-z2]... You must specify bus and port numbers in hexadecimal. You cannot use the wildcard character in paths. For example: bus-1/2_port-02;bus-1/7/1/4_port-0f The default value is undefined.
Include Vid/Pid Device	Includes devices with specified vendor and product IDs that can be redirected. The format of the setting is vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... You must specify ID numbers in hexadecimal. You can use the wildcard character (*) in place of individual digits in an ID. For example: vid-0561_pid-554c The default value is undefined.