设置 USB 配置属性

您可以在 /etc/vmware/config、/usr/lib/vmware/config 和 ~/.vmware/config 配置文件中设置 USB 配置属性。

使用下面的语法在配置文件中设置 USB 配置属性。

viewusb.property1 = "value1"

通过使用 USB 配置属性，您可以控制是否重定向某些类型的设备。也可以使用筛选属性，以便包含或排除某些类型的设备。此外还提供了用于拆分复合设备的属性。

有些属性值要求提供 USB 设备的 VID（供应商 ID）和 PID（产品 ID）。要查找 VID 和 PID，可在 Internet 上以产品名称与 vid 和 pid 的组合作为关键字进行搜索。或者，也可以在 Horizon Client 运行过程中将 USB 设备插入本地系统，然后在 /tmp/vmware-<current_user>/vmware-view-usbd-*.log 文件中查找。要设置此文件位置，可使用 /etc/vmware/config 文件中的 view-usbd.log.fileName 属性，例如：

 view-usbd.log.fileName = "/tmp/usbd.log"

下表介绍了可用的 USB 配置属性。

表 1. USB 重定向的配置属性
策略名称和属性	说明
允许自动设备拆分属性： viewusb.AllowAutoDeviceSplitting	允许复合 USB 设备的自动拆分。未定义默认值，相当于 `false`。
Exclude Vid/Pid Device From Split（从拆分中排除 Vid/Pid 设备）属性： viewusb.SplitExcludeVidPid	从拆分中排除按供应商和产品 ID 指定的复合 USB 设备。该设置的格式为 vid-`xxx1`_pid-`yyy1`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (``) 代替 ID 中的单个数字。例如：`vid-0781_pid-55*` 未定义默认值。
Split Vid/Pid Device（拆分 Vid/Pid 设备）属性： viewusb.SplitVidPid	将按供应商和产品 ID 指定的复合 USB 设备的组件视为单独设备。设置的格式为 vid-`xxxx`_pid-`yyyy`([exintf:`zz`[;exintf:`ww` ]])[;...] 可以使用 exintf 关键字通过指定接口号禁止重定向组件。您必须以十六进制格式指定 ID 号，以十进制格式（包含前导零）指定接口号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0781_pid-554c(exintf:01;exintf:02)` 注：如果复合设备包含自动排除的组件（例如鼠标和键盘组件），则 Horizon Client 不会自动包含您未明确排除的组件。您必须指定一个筛选策略（如 Include Vid/Pid Device）来包含这些组件。未定义默认值。
Allow Audio Input Devices（允许音频输入设备）属性： viewusb.AllowAudioIn	允许音频输入设备进行重定向。未定义默认值，相当于 `false`，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
Allow Audio Output Devices（允许音频输出设备）属性： viewusb.AllowAudioOut	允许音频输出设备进行重定向。未定义默认值，相当于 `false`。
允许 HID 属性： viewusb.AllowHID	允许除键盘或鼠标之外的输入设备进行重定向。未定义默认值，相当于 `true`。
Allow HIDBootable（允许可引导的 HID）属性： viewusb.AllowHIDBootable	允许开机时除键盘或鼠标之外的其他可用输入设备（又称为可引导的 hid 设备）进行重定向。未定义默认值，相当于 `true`。
允许设备描述符故障防护属性： viewusb.AllowDevDescFailsafe	即使 Horizon Client 未能获取配置/设备描述符，依然允许设备进行重定向。要在设备出现配置/描述符问题时依然允许它进行重定向，可将其添加到 Include 筛选器中，如 IncludeVidPid 或 IncludePath。未定义默认值，相当于 `false`。
Allow Keyboard and Mouse Devices（允许键盘和鼠标设备）属性： viewusb.AllowKeyboardMouse	允许键盘以及集成指针设备（例如，鼠标、轨迹球或触摸板）进行重定向。未定义默认值，相当于 `false`。
Allow Smart Cards（允许智能卡）属性： viewusb.AllowSmartcard	允许智能卡设备进行重定向。未定义默认值，相当于 `false`。
Allow Video Devices（允许视频设备）属性： viewusb.AllowVideo	允许视频设备进行重定向。未定义默认值，相当于 `false`，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
禁用远程配置下载属性： viewusb.DisableRemoteConfig	在执行 USB 设备筛选时，不允许使用 Horizon Agent 设置。未定义默认值，相当于 `false`。
Exclude All Devices（排除所有设备）属性： viewusb.ExcludeAllDevices	禁止任何 USB 设备进行重定向。如果设置为 `true`，可以使用其他策略设置来允许对特定设备或设备系列进行重定向。如果设置为 `false`，可以使用其他策略设置来防止特定设备或系列设备进行重定向。如果将 Horizon Agent 上的 Exclude All Devices 值设为 `true`，并将该设置传递到 Horizon Client，则 Horizon Agent 设置将覆盖 Horizon Client 设置。未定义默认值，相当于 `false`。
Exclude Device Family（排除设备系列）属性： viewusb.ExcludeFamily	禁止设备系列进行重定向。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`bluetooth;smart-card` 如果您启用了自动设备拆分，则 Horizon Client 会检查复合 USB 设备每个接口的设备系列，确定应排除哪些接口。如果您关闭了自动设备拆分，则 Horizon Client 会检查整个复合 USB 设备的设备系列。未定义默认值。
Exclude Vid/Pid Device（排除 Vid/Pid 设备）属性： viewusb.ExcludeVidPid	禁止具有指定供应商和产品 ID 的设备进行重定向。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (``) 代替 ID 中的单个数字。例如：`vid-0781_pid-***;vid-0561_pid-554c` 未定义默认值。
Exclude Path（排除路径）属性： viewusb.ExcludePath	禁止位于指定集线器或端口路径的设备进行重定向。设置的格式为 bus-`x1`[/`y1`]..._port-`z1`[;bus-`x2`[/`y2`]..._port-`z2`]... 您必须以十六进制格式指定总线和端口号。在路径中不能使用通配符。例如：`bus-1/2/3_port-02;bus-1/1/1/4_port-ff` 未定义默认值。
Include Device Family（包含设备系列）属性： viewusb.IncludeFamily	包含可以进行重定向的设备系列。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`storage` 未定义默认值。
Include Path（包含路径）属性： viewusb.IncludePath	包含位于指定集线器或端口路径的可重定向设备。设置的格式为 bus-`x1`[/`y1`]..._port-`z1`[;bus-`x2`[/`y2`]..._port-`z2`]... 您必须以十六进制格式指定总线和端口号。在路径中不能使用通配符。例如：`bus-1/2_port-02;bus-1/7/1/4_port-0f` 未定义默认值。
Include Vid/Pid Device（包含 Vid/Pid 设备）属性： viewusb.IncludeVidPid	包含具有指定供应商和产品 ID 的可重定向设备。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0561_pid-554c` 未定义默认值。
禁止自动转发设备系列属性： viewusb.ExAutoRedirectFamily	禁止设备系列被自动转发。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`storage` 未定义默认值。
禁止自动转发 Vid/Pid 设备属性： viewusb.ExAutoRedirectVidPid	禁止具有指定供应商和产品 ID 的设备被自动转发。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0561_pid-554c` 未定义默认值。

USB 重定向示例

每个示例后都有对 USB 重定向效果的描述。

将大多数设备加入鼠标设备系列。
```
viewusb.IncludeFamily = "mouse" 
viewusb.ExcludeVidPid = "Vid-0461_Pid-0010;Vid-0461_Pid-4d20"
```
该示例中的第一个属性指示 Horizon Client 允许将鼠标设备重定向到远程桌面。第二个属性覆盖第一个属性，指示 Horizon Client 将两种特定鼠标设备保留为本地状态，不进行重定向。
启用自动设备拆分，但是将其中一个特定设备从拆分操作中排除。对于另外一个特定设备，将其中的一个组件保留为本地状态，其他组件重定向到远程桌面：
```
viewusb.AllowAutoDeviceSplitting = "True"
viewusb.SplitExcludeVidPid = "Vid-03f0_Pid-2a12"
viewusb.SplitVidPid = "Vid-0911_Pid-149a(exintf:03)"
viewusb.IncludeVidPid = "Vid-0911_Pid-149a"
```
复合 USB 设备包含两台或更多设备，例如视频输入设备和存储设备。本例中的第一个属性启用了对复合设备的自动拆分。第二个属性则从拆分操作中排除了指定的复合 USB 设备 (Vid-03f0_Pid-2a12)。

第三行指示 Horizon Client 将其他复合设备 (Vid-0911_Pid-149a) 的组件视为独立的设备，但禁止以下组件进行重定向：接口号为 03 的组件。该组件保留为本地状态。

由于该复合设备包含一个默认情况下通常会排除的组件（例如，鼠标或键盘），因此有必要添加第四行，从而使复合设备 Vid-0911_Pid-149a 的其他组件可以重定向到远程桌面。

前三项属性属于拆分属性。最后一项属性为筛选属性。筛选属性的处理顺序先于拆分属性。

重要说明：这些客户端配置属性可能与针对远程桌面上的 Horizon Agent 设置的相应策略合并，也可能被其覆盖。有关客户端上的 USB 拆分和筛选属性如何与 Horizon Agent USB 策略配合工作的信息，请参阅《Horizon 远程桌面功能和 GPO》文档中有关使用策略来控制 USB 重定向的主题。

策略名称和属性	说明
允许自动设备拆分属性： viewusb.AllowAutoDeviceSplitting	允许复合 USB 设备的自动拆分。未定义默认值，相当于 `false`。
Exclude Vid/Pid Device From Split（从拆分中排除 Vid/Pid 设备）属性： viewusb.SplitExcludeVidPid	从拆分中排除按供应商和产品 ID 指定的复合 USB 设备。该设置的格式为 vid-`xxx1`_pid-`yyy1`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (``) 代替 ID 中的单个数字。例如：`vid-0781_pid-55*` 未定义默认值。
Split Vid/Pid Device（拆分 Vid/Pid 设备）属性： viewusb.SplitVidPid	将按供应商和产品 ID 指定的复合 USB 设备的组件视为单独设备。设置的格式为 vid-`xxxx`_pid-`yyyy`([exintf:`zz`[;exintf:`ww` ]])[;...] 可以使用 exintf 关键字通过指定接口号禁止重定向组件。您必须以十六进制格式指定 ID 号，以十进制格式（包含前导零）指定接口号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0781_pid-554c(exintf:01;exintf:02)` 注：如果复合设备包含自动排除的组件（例如鼠标和键盘组件），则 Horizon Client 不会自动包含您未明确排除的组件。您必须指定一个筛选策略（如 Include Vid/Pid Device）来包含这些组件。未定义默认值。
Allow Audio Input Devices（允许音频输入设备）属性： viewusb.AllowAudioIn	允许音频输入设备进行重定向。未定义默认值，相当于 `false`，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
Allow Audio Output Devices（允许音频输出设备）属性： viewusb.AllowAudioOut	允许音频输出设备进行重定向。未定义默认值，相当于 `false`。
允许 HID 属性： viewusb.AllowHID	允许除键盘或鼠标之外的输入设备进行重定向。未定义默认值，相当于 `true`。
Allow HIDBootable（允许可引导的 HID）属性： viewusb.AllowHIDBootable	允许开机时除键盘或鼠标之外的其他可用输入设备（又称为可引导的 hid 设备）进行重定向。未定义默认值，相当于 `true`。
允许设备描述符故障防护属性： viewusb.AllowDevDescFailsafe	即使 Horizon Client 未能获取配置/设备描述符，依然允许设备进行重定向。要在设备出现配置/描述符问题时依然允许它进行重定向，可将其添加到 Include 筛选器中，如 IncludeVidPid 或 IncludePath。未定义默认值，相当于 `false`。
Allow Keyboard and Mouse Devices（允许键盘和鼠标设备）属性： viewusb.AllowKeyboardMouse	允许键盘以及集成指针设备（例如，鼠标、轨迹球或触摸板）进行重定向。未定义默认值，相当于 `false`。
Allow Smart Cards（允许智能卡）属性： viewusb.AllowSmartcard	允许智能卡设备进行重定向。未定义默认值，相当于 `false`。
Allow Video Devices（允许视频设备）属性： viewusb.AllowVideo	允许视频设备进行重定向。未定义默认值，相当于 `false`，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
禁用远程配置下载属性： viewusb.DisableRemoteConfig	在执行 USB 设备筛选时，不允许使用 Horizon Agent 设置。未定义默认值，相当于 `false`。
Exclude All Devices（排除所有设备）属性： viewusb.ExcludeAllDevices	禁止任何 USB 设备进行重定向。如果设置为 `true`，可以使用其他策略设置来允许对特定设备或设备系列进行重定向。如果设置为 `false`，可以使用其他策略设置来防止特定设备或系列设备进行重定向。如果将 Horizon Agent 上的 Exclude All Devices 值设为 `true`，并将该设置传递到 Horizon Client，则 Horizon Agent 设置将覆盖 Horizon Client 设置。未定义默认值，相当于 `false`。
Exclude Device Family（排除设备系列）属性： viewusb.ExcludeFamily	禁止设备系列进行重定向。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`bluetooth;smart-card` 如果您启用了自动设备拆分，则 Horizon Client 会检查复合 USB 设备每个接口的设备系列，确定应排除哪些接口。如果您关闭了自动设备拆分，则 Horizon Client 会检查整个复合 USB 设备的设备系列。未定义默认值。
Exclude Vid/Pid Device（排除 Vid/Pid 设备）属性： viewusb.ExcludeVidPid	禁止具有指定供应商和产品 ID 的设备进行重定向。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (``) 代替 ID 中的单个数字。例如：`vid-0781_pid-***;vid-0561_pid-554c` 未定义默认值。
Exclude Path（排除路径）属性： viewusb.ExcludePath	禁止位于指定集线器或端口路径的设备进行重定向。设置的格式为 bus-`x1`[/`y1`]..._port-`z1`[;bus-`x2`[/`y2`]..._port-`z2`]... 您必须以十六进制格式指定总线和端口号。在路径中不能使用通配符。例如：`bus-1/2/3_port-02;bus-1/1/1/4_port-ff` 未定义默认值。
Include Device Family（包含设备系列）属性： viewusb.IncludeFamily	包含可以进行重定向的设备系列。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`storage` 未定义默认值。
Include Path（包含路径）属性： viewusb.IncludePath	包含位于指定集线器或端口路径的可重定向设备。设置的格式为 bus-`x1`[/`y1`]..._port-`z1`[;bus-`x2`[/`y2`]..._port-`z2`]... 您必须以十六进制格式指定总线和端口号。在路径中不能使用通配符。例如：`bus-1/2_port-02;bus-1/7/1/4_port-0f` 未定义默认值。
Include Vid/Pid Device（包含 Vid/Pid 设备）属性： viewusb.IncludeVidPid	包含具有指定供应商和产品 ID 的可重定向设备。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0561_pid-554c` 未定义默认值。
禁止自动转发设备系列属性： viewusb.ExAutoRedirectFamily	禁止设备系列被自动转发。设置的格式为 `family_name_1`[;`family_name_2`]... 例如：`storage` 未定义默认值。
禁止自动转发 Vid/Pid 设备属性： viewusb.ExAutoRedirectVidPid	禁止具有指定供应商和产品 ID 的设备被自动转发。设置的格式为 vid-`xxx1`_pid-`yyy2`[;vid-`xxx2`_pid-`yyy2`]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (`*`) 代替 ID 中的单个数字。例如：`vid-0561_pid-554c` 未定义默认值。