EnglishFrançaisDeutschEspañolItaliano日本語한국어NederlandsPortuguês (Brasil)中文 (简体)中文 (繁體, 台灣)
Skip to main content

2026 年 7 月 28 日

设置 USB 配置属性

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

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

viewusb.property1 = "value1"

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

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

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

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

USB 重定向的配置属性
策略名称和属性说明
允许自动设备拆分 属性： viewusb.AllowAutoDeviceSplitting允许复合 USB 设备的自动拆分。 未定义默认值，相当于 false。
从拆分中排除 Vid/Pid 设备 属性： viewusb.SplitExcludeVidPid从拆分中排除按供应商和产品 ID 指定的复合 USB 设备。该设置的格式为 vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (*) 代替 ID 中的单个数字。 例如：vid-0781_pid-55** 未定义默认值。
拆分 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 不会自动包含您未明确排除的组件。您必须指定一个筛选策略（如“包含 Vid/Pid 设备”）来包含这些组件。 未定义默认值。
允许音频输入设备 属性： viewusb.AllowAudioIn允许音频输入设备进行重定向。 未定义默认值，相当于 false，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
允许音频输出设备 属性： viewusb.AllowAudioOut允许音频输出设备进行重定向。 未定义默认值，相当于 false。
允许 HID 属性： viewusb.AllowHID允许除键盘或鼠标之外的输入设备进行重定向。 未定义默认值，相当于 true。
允许可引导的 HID 属性： viewusb.AllowHIDBootable允许引导时除键盘或鼠标之外的其他可用输入设备（又称为可引导的 hid 设备）进行重定向。 未定义默认值，相当于 true。
允许设备描述符故障防护 属性： viewusb.AllowDevDescFailsafe即使 Horizon Client 未能获取配置/设备描述符，也仍然允许对设备进行重定向。 要在设备配置/描述失败时也仍然允许对其进行重定向，可将该设备包含在 Include 筛选器中，例如 IncludeVidPid 或 IncludePath。 未定义默认值，相当于 false。
允许键盘和鼠标设备 属性： viewusb.AllowKeyboardMouse允许键盘以及集成指针设备（例如，鼠标、轨迹球或触摸板）进行重定向。 未定义默认值，相当于 false。
允许智能卡 属性： viewusb.AllowSmartcard允许智能卡设备进行重定向。 未定义默认值，相当于 false。
允许视频设备 属性： viewusb.AllowVideo允许视频设备进行重定向。 未定义默认值，相当于 false，因为默认情况下“实时音频-视频”功能用于音频输入和视频设备，USB 重定向不用于这些设备。
禁用远程配置下载 属性： viewusb.DisableRemoteConfig在执行 USB 设备筛选时，不允许使用 Horizon Agent 设置。 未定义默认值，相当于 false。
排除所有设备 属性： viewusb.ExcludeAllDevices禁止任何 USB 设备进行重定向。如果设置为 true，可以使用其他策略设置来允许对特定设备或设备系列进行重定向。如果设置为 false，可以使用其他策略设置来防止对特定设备或设备系列进行重定向。 如果将 Horizon Agent 上的“排除所有设备”的值设置为 true，并将此设置传递到 Horizon Client，则 Horizon Agent 设置将覆盖 Horizon Client 设置。 未定义默认值，相当于 false。
排除设备系列 属性： viewusb.ExcludeFamily禁止设备系列进行重定向。设置的格式为 family_name_1[;family_name_2]... 例如：bluetooth;smart-card 如果启用了自动设备拆分，Horizon Client 会检查复合 USB 设备的每个接口的设备系列以确定应排除哪些接口。如果禁用了自动设备拆分，Horizon Client 会检查整个复合 USB 设备的设备系列。 未定义默认值。
排除 Vid/Pid 设备 属性： viewusb.ExcludeVidPid从重定向中排除具有指定供应商和产品 ID 的设备。设置的格式为 vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... 您必须以十六进制格式指定 ID 号。可以使用通配符 (*) 代替 ID 中的单个数字。 例如：vid-0781_pid-****;vid-0561_pid-554c 未定义默认值。
排除路径 属性： 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 未定义默认值。
包含设备系列 属性： viewusb.IncludeFamily 包含可以进行重定向的设备系列。设置的格式为 family_name_1[;family_name_2]... 例如：storage 未定义默认值。
包含路径 属性： viewusb.IncludePath 包含位于指定集线器或端口路径的可重定向设备。设置的格式为 bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]... 您必须以十六进制格式指定总线和端口号。在路径中不能使用通配符。 例如：bus-1/2_port-02;bus-1/7/1/4_port-0f 未定义默认值。
包含 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 重定向的主题。

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

请勿填写任何个人信息或机密信息。

正在生成链接…