Configuring composite USB device redirection

Configuring composite USB redirection using the Group Policy Object (GPO) administrative template

  1. Open the Citrix Receiver Group Policy Object administrative template by running gpedit.msc.
  2. Under the User Configuration node, go to Administrative Templates > Citrix Components > Citrix Receiver > Remoting client devices > Generic USB Remoting.
  3. Select the SplitDevices policy.
  4. Select Enabled.
  5. Click Apply.
  6. Click OK to save the policy.

To allow or deny an interface using the Group Policy Object administrative template

  1. Open the Citrix Receiver Group Policy Object administrative template by running gpedit.msc.
  2. Under the User Configuration node, go to Administrative Templates > Citrix Components > Citrix Receiver > Remoting client devices > Generic USB Remoting.
  3. Select USB Device Rules policy.
  4. Select Enabled.
  5. In the USB Device Rules text box, add the USB device that you want to allow or deny. For example, ALLOW: vid=047F pid= C039 split=01 intf=00,03 //Allowed 00 and 03 interface, restrict others.
  6. Click Apply and OK.

In a desktop session, split USB devices are displayed in the desktop viewer under Devices. Additionally, you can view split USB devices from Preferences > Devices.

alt_text

In an application session, split USB devices are displayed in the Connection Center.

alt_text

The table below provides details on the behavior scenarios when a USB interface is allowed or denied.

To allow an interface:

Split Interface Action
TRUE Valid number 0 -n Allow specified interface
TRUE Invalid number Allow all interfaces
FALSE Any value Allow Generic USB of parent device
Not specified Any value Allow Generic USB of parent device

For example, SplitDevices- true indicates that all devices split.

To deny an interface:

Split Interface Action
TRUE Valid number 0 -n Deny specified interface
TRUE Invalid number Deny all interfaces
FALSE Any value Deny Generic USB of parent device
Not specified Any value Deny Generic USB of parent device

For example, SplitDevices- false indicates that devices are not split with specified interface number.

Example: My_<plantronics> headset

Interface number

  • Audio Interface Class -0
  • HID Interface Class-3

Sample rules used for My_<plantronics> headset:

  • ALLOW: vid=047F pid= C039 split=01 intf=00,03 //Allowed 00 and 03 interface, restrict others
  • DENY: vid=047F pid= C039 split=01 intf=00,03 // deny 00 and 03

Limitation:

Citrix recommends that you do not split interfaces for a webcam. As a workaround, redirect the device to a single device using Generic USB redirection. For a better performance, use the optimized virtual channel.