USB 诊断工具

Last published : Nov 13, 2026

CtxUsbDiagnostics.exe 是 VDA 上的一个命令行工具，可帮助 Citrix 管理员快速诊断和解决客户端上遇到的 USB 设备重定向问题。此实用工具收集了对连接到客户端但无法在 HDX 会话中重定向的 USB 设备相关的配置问题进行分类所需的重要信息。

注意：

需要以管理员身份运行命令提示符或 PowerShell，以确保该工具具有执行系统级操作所需的权限。
CtxUsbDiagnostics.exe 位于 C:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe。并且已是环境变量的一部分。您无需导航到此路径，可以直接在具有提升权限的命令提示符下运行此工具。

要求

操作系统
- Windows 10 1809 或更高版本
- Windows 11 21H2 或更高版本
- Windows Server 2016 或更高版本
VDA
- Windows: Citrix Virtual Apps and Desktops™ 版本 2311 或更高版本

该工具目前提供：

Citrix Studio 规则 - 版本 1/2
- DDC 规则指示在 Studio 中使用旧版“客户端 USB 设备重定向规则”或“客户端 USB 设备重定向规则（版本 2）”策略。本节列出的信息包含 Citrix® 管理员配置的所有规则。
客户端默认设备规则
- 本节列出了在客户端注册表中设置的规则。
设备优化规则
- 本节列出了在“客户端 USB 设备优化规则”中设置的设备优化规则。

本节列出了有关连接到客户端端点的每个设备的有价值信息、硬件信息、设备是否正在重定向、是否设置了正确的设备重定向规则等等。

标签名称	描述
显示名称	列出设备的通用名称。
供应商 ID	供应商 ID
产品 ID	产品 ID
接口	如果复合设备已拆分为多个子设备，此子部分将列出所有接口。
接口编号	指示接口描述符的索引
类	类代码
子类	子类代码
协议	协议
redirectionState	Local 表示设备未在 ICA® 会话中重定向。ThisSession 表示设备已在 ICA 会话中重定向。OtherSession 表示设备已在另一个 ICA 会话中重定向。
deviceType	generic 表示设备没有优化的虚拟通道，并且流量正在通过 USB 虚拟通道传输。optimized 意味着与设备相关的数据传输正在通过专用虚拟通道进行。
isDenied	true 表示设备因管理员设置的策略规则而未重定向。`false` 表示设备因应用策略而重定向。
denyRule	如果 isDenied 设置为 `true`，此字段很有用。它会告知管理员策略中导致设备未重定向的具体规则集。
deviceDriver	此字段指示 VDI 主机上是否存在相应的驱动程序。

此外，每个设备都包含一个摘要部分，该部分可让用户了解设备在 HDX 会话中的可用性。