故障排除

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

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

2. 确保配置与您的环境中使用的组件版本和平台相符。有关需要旧版配置设置的组件的详细信息，请参阅“旧版 USB 重定向配置”中的说明。

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

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

   2. CtxUsbDiagnostics.exe（推荐）：在命令提示符窗口中运行此工具。输出将为您提供特定会话的设备特定信息。它会告诉您设备是否正在重定向。它还会告诉您设备规则集是否导致设备未被重定向。有关更多信息，请参阅诊断工具。

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

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

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

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

5. 如果您没有看到设备在会话中显示：

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

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

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

   1. 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 问题进行排查，请参阅 CWA for Linux 的 USB 文档。

   3. 适用于 Mac 的 CWA - 要对适用于 Mac 的 CWA 问题进行排查，请参阅 适用于 Mac 的 CWA

注意：

• 在 TSVDA 上，默认情况下，音频设备被阻止使用 USB 重定向。使用这些设备的推荐方法是使用优化的音频虚拟通道 (Audio VC)。

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

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

  • 拔下 USB 设备，然后重新插入。此操作将使设备脱离低功耗模式。

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

事件日志

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