故障排除

Last published : Oct 24, 2026
应遵循以下步骤来分类 USB 重定向相关问题:
  1. 验证 USB 重定向是否满足系统要求。这包括正确的 CVAD 和 CWA 版本,以及所考虑的操作系统平台上支持的设备和设备驱动程序。
  2. 确保配置根据您环境中使用的组件版本和平台是适当的。有关需要 (/zh-cn/citrix-daas/devices/usb-devices/legacy-usb-redirection-configuration.html) 的组件的详细信息,请参阅旧版 USB 重定向配置中的说明。
  3. 验证设备是否列在客户端已枚举的设备下。
    1. Workspace 首选项工具栏:查看 Workspace 应用程序首选项工具栏的“设备”选项卡中枚举的设备(右键单击 CWA 图标 > 连接中心 > 首选项…单击“设备”选项卡)。
    2. CtxUsbDiagnostics.exe(推荐):在命令提示符窗口中运行此工具。输出会为您提供特定会话的设备特定信息。它会告诉您设备是否正在重定向。它还会告诉您设备规则集是否导致设备未重定向。有关更多信息,请参阅 (/zh-cn/citrix-daas/devices/usb-devices/usb-diagnostics-tool.html)。
    3. USBView 或其他第三方工具:在端点/客户端计算机上运行 USBView 等第三方工具,以确保在端点检测到设备。
  4. 如果您看到设备正在枚举:
    1. 如果您在 CtxUsbDiagnostics 工具输出中看到特定设备的拒绝规则,请检查 Studio 中配置的策略,并确保在版本 2 策略中正确设置了规则。如果拒绝规则未出现在 Studio 策略中,请按顺序检查客户端策略,最后检查客户端默认设置,以找到匹配的拒绝规则。
    2. 如果 CtxUsbDiagnostics 输出中没有拒绝规则,则 CWA 将通过选中/单击“首选项”窗口的“设备”选项卡(设备 > 管理设备)中的相应按钮来允许设备重定向。设备一旦重定向,将在会话中可用。这可以通过检查 HDX 会话中的设备管理器/USBView 或类似应用程序来验证。
  5. 如果您没有看到设备在会话中显示:
    1. VDA 主机上可能未正确安装正确的设备驱动程序。确保在 VDA 主机上正确安装了最新版本的设备驱动程序。某些设备驱动程序在终端服务器计算机上不受支持,因此请确保您尝试重定向的设备不存在这种情况。
    2. 确保设备未在客户端端点上使用。某些设备也需要在客户端端点上安装驱动程序,这可能会阻止它们在会话中重定向。
  6. 验证客户端端点上是否正确设置了 USB 相关规则:
    1. 适用于 Windows 的 CWA:
      1. 验证客户端上的组策略(为此添加更多详细信息和屏幕截图)是否已正确设置,并且不与 Studio 中设置的规则冲突。
      2. 验证客户端注册表中的默认规则。
      设备故障排除
      (HKLM\SOFTWARE\Wow6432Node\Citrix\PortICA\GenericUSB\DeviceRules) are appropriately set and not in conflict with the rules set in Studio and client group policy..
    2. 适用于 Linux 的 CWA - 要分类处理适用于 Linux 的 CWA 问题,请参阅适用于 Linux 的 CWA的 USB 文档
    3. 适用于 Mac 的 CWA - 要分类处理适用于 Mac 的 CWA 问题,请参阅适用于 Mac 的 CWA
注意:
  • 在 TSVDA 上,默认情况下,音频设备被阻止使用 USB 重定向。使用这些设备的推荐方法是使用优化的音频虚拟通道。
  • 有时,即使已设置正确的设备重定向规则来拆分设备,USB 复合设备也可能不会自动拆分。出现此问题是因为设备处于低功耗模式。在这种情况下,进入低功耗模式的子设备可能不会出现在设备列表中。您可以使用以下变通办法来解决此问题:
    • 断开会话,插入 USB 设备,然后重新连接到会话。
    • 拔下 USB 设备,然后重新插入。此操作会导致设备退出低功耗模式。
  • 有时,可能会启用 USB 节电设置以优化电池续航时间。如果客户端端点进入睡眠状态,USB 设备可能会断开连接。在这种情况下,您可能需要断开连接并重新连接设备,才能在会话中再次呈现该设备。

事件日志

管理员现在可以监视用户可能尝试重定向的未经授权的设备,并可以采取适当的措施。以下是一些事件消息,这些消息将记录在 VDA 主机上的事件查看器中,适用于允许重定向的设备和不允许重定向的设备。
事件日志1
事件日志2
事件日志3