Installation and Setup Guide

Table 6‑1. Configuration Properties for USB Redirection (Continued)
Policy Name and Property Description
Include Path
Property:
viewusb.IncludePath
Include devices at a specied hub or port paths that can be redirected. The format of
the seing 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 undened.
Include Vid/Pid Device
Property:
viewusb.IncludeVidPid
Includes devices with specied vendor and product IDs that can be redirected. The
format of the seing 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 undened.
USB Redirection Examples
Each example is followed by a description of the eect on USB redirection.
n
Include most devices within mouse device family.
viewusb.IncludeFamily = "mouse"
viewusb.ExcludeVidPid = "Vid-0461_Pid-0010;Vid-0461_Pid-4d20"
The rst property in this example tells Horizon Client to allow mouse devices to be redirected to a View
desktop. The second property overrides the rst and tells Horizon Client to keep two specic mouse
devices local and not redirect them.
n
Turn on automatic device spliing, but exclude one particular device from spliing. For another
particular device, keep one of its components local and redirect the other components to the remote
desktop:
viewusb.AllowAutoDeviceSplitting = "True"
viewusb.SplitExcludeVidPid = "Vid-03f0_Pid-2a12"
viewusb.SplitVidPid = "Vid-0911_Pid-149a(exintf:03)"
viewusb.IncludeVidPid = "Vid-0911_Pid-149a"
Composite USB devices consist of a combination of two or more devices, such as a video input device
and a storage device. The rst property in this example turns on automatic spliing of composite
devices. The second property excludes the specied composite USB device (Vid-03f0_Pid-2a12) from
spliing.
The third line tells Horizon Client to treat the components of a dierent composite device
(Vid-0911_Pid-149a) as separate devices but to exclude the following component from being redirected:
the component whose interface number is 03. This component is kept local.
Because this composite device includes a component that is ordinarily excluded by default, such as a
mouse or keyboard, the fourth line is necessary so that the other components of the composite device
Vid-0911_Pid-149a can be redirected to the View desktop.
The rst three properties are spliing properties. The last property is a ltering property. Filtering
properties are processed before spliing properties.
I These client conguration properties might be merged with or overridden by corresponding
policies set for View Agent on the remote desktop. For information about how USB spliing and ltering
properties on the client work in conjunction with View Agent USB policies, see the topics about using
policies to control USB redirection, in the View Administration document.
Chapter 6 Configuring USB Redirection on the Client
VMware, Inc. 85