产品文档
Citrix Virtual Apps and Desktops
服务 当前版本 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
查看 PDF

故障排除

June 2, 2026
投稿者: 
C

应遵循以下步骤来分类 USB 重定向相关问题：

  1. 验证 USB 重定向是否满足系统要求。这包括正确的 CVAD 和 CWA 版本，以及所考虑的操作系统平台上支持的设备和设备驱动程序。

  2. 根据您环境中使用的组件版本和平台，确保配置适当。有关需要 (/zh-cn/citrix-virtual-apps-desktops/2511/devices/usb-devices/legacy-usb-redirection-configuration.html) 的组件的详细信息，请参阅“旧版 USB 重定向配置”中的说明。

  3. 验证设备是否列在客户端已枚举的设备下。

    1. 工作区首选项工具栏：查看 Workspace 应用首选项工具栏的“设备”选项卡中列出的设备（右键单击 CWA 图标 > 连接中心 > 首选项… 单击“设备”选项卡）。

    2. CtxUsbDiagnostics.exe（推荐）：在命令提示符窗口中运行此工具。输出为您提供特定会话的设备特定信息。它会告诉您设备是否正在重定向。它还会告诉您设备规则集是否导致设备未被重定向。有关详细信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/2511/devices/usb-devices/usb-diagnostics-tool.html)。

    3. USBView 或其他第三方工具：在端点/客户端计算机上运行 USBView 等第三方工具，以确保在端点检测到设备。

  4. 如果您看到设备正在枚举：

    1. 如果您在 CtxUsbDiagnostics 工具输出中看到特定设备的拒绝规则，请检查 Studio 中配置的策略，并确保在 Version 2 策略中正确设置了规则。如果拒绝规则未出现在 Studio 策略中，请按顺序检查客户端策略，最后检查客户端默认设置，以找到匹配的拒绝规则。

    2. 如果 CtxUsbDiagnostics 输出中没有拒绝规则，则 CWA 将通过在 Preferences 窗口的 Devices 选项卡中选中/单击相应的按钮（Devices > Manage devices）来允许重定向设备。重定向的设备将在会话中可用。这可以通过检查 HDX 会话中的设备管理器/USBView 或类似应用程序来验证。

  5. 如果您没有看到该设备在会话中呈现：

    1. 可能 VDA 主机上未正确安装正确的设备驱动程序。确保在 VDA 主机上正确安装了最新版本的设备驱动程序。某些设备驱动程序在终端服务器计算机上不受支持，因此请确保您尝试重定向的设备不是这种情况。

    2. 确保设备未在客户端端点上使用。某些设备还需要在客户端端点上安装驱动程序，这可能会阻止它们在会话中被重定向。

  6. 验证客户端端点上是否正确设置了 USB 相关规则：

    1. 适用于 Windows 的 工作区应用程序 :

      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 重定向。使用这些设备的推荐方法是使用优化的 Audio VC。

  • 有时，即使已设置正确的设备重定向规则来拆分设备，USB 复合设备也可能不会自动拆分。出现此问题是因为设备处于低功耗模式。在这种情况下，进入低功耗模式的子设备可能不会出现在设备列表中。您可以使用以下解决方法来解决此问题：

    • 断开会话，插入 USB 设备，然后重新连接到会话。

    • 拔下 USB 设备并重新插入。此操作会导致设备退出低功耗模式。

  • 有时，可能会启用 USB 节电设置以优化电池续航时间。如果客户端端点进入睡眠状态，USB 设备可能会断开连接。在这种情况下，您可能需要断开并重新连接设备，以便在会话中再次呈现该设备。

事件日志

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

事件日志1

事件日志2

事件日志3

故障排除
June 2, 2026
投稿者: 
C
June 2, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.