USB 诊断工具
CtxUsbDiagnostics.exe 是 VDA 上的一个命令行工具，可帮助 Citrix 管理员以加速的方式诊断和解决客户端上遇到的 USB 设备重定向问题。此实用工具收集了对连接到客户端但无法在 HDX 会话中重定向的 USB 设备相关的配置问题进行分类所需的重要信息。
> **Note :**
>
> Running Command Prompt or Powershell as an administrator is required to ensure the tool has the necessary permissions to perform system-level operations.
要求
会话主机
-
操作系统
-
Windows 10 1809 或更高版本
-
Windows 11 21H2 或更高版本
-
Windows Server 2016 或更高版本
-
-
VDA
-
Windows: Citrix Virtual Apps and Desktops™ 版本 2311 或更高版本
-
客户端设备
-
操作系统
-
Windows 10 1809 或更高版本
-
-
Workspace 应用程序
-
Windows: 版本 2311 或更高版本
-
工具的作用是什么?
该工具目前提供：
-
会话ID
-
VDA 设备策略（在 Studio 中设置的设备规则）
-
客户端设备和客户端设备策略（设备规则）
-
设备列表、其重定向状态以及允许或拒绝它们的原因
注意：管理员可以查看所有活动会话的设备信息。
显示的信息
-
Citrix Studio 规则 - 版本 1/2
-
DDC 规则指示在 Studio 中使用了旧版“客户端 USB 设备重定向规则”或“客户端 USB 设备重定向规则（版本 2）”策略。本节列出的信息包含 Citrix® 管理员配置的所有规则。
-
-
客户端默认设备规则
-
本节列出了在客户端注册表中设置的规则。
-
-
设备优化规则
-
本节列出了“客户端 USB 设备优化规则”中设置的设备优化规则。
-
设备列表
本节列出了有关连接到客户端端点的每个设备的宝贵信息，包括硬件信息、是否正在重定向、是否设置了正确的设备重定向规则等。
| 标签名称 | 描述 |
|---|---|
| displayName | 列出设备的通用名称。 |
| 供应商 ID | 供应商 ID |
| 产品 ID | 产品 ID |
| 接口 | 本小节列出了所有接口，以防复合设备已拆分为多个子设备。 |
| 接口编号 | 指示接口描述符的索引 |
| 类 | 类代码 |
| 子类 | 子类代码 |
| 协议 | 协议 |
| 重定向状态 | Local 表示设备未在 ICA® 会话中重定向。ThisSession 表示设备已在此 ICA 会话中重定向。OtherSession 表示设备已在其他 ICA 会话中重定向。 |
| 优化已启用 | true 表示设备已优化。false 表示设备未优化，数据传输通过 USB 虚拟通道进行。 |
| 设备类型 | generic 表示设备没有优化的虚拟通道，流量通过 USB 虚拟通道传输。optimized 表示与设备相关的数据传输通过专用虚拟通道进行。 |
| isDenied | true 表示设备因管理员设置的策略规则而未重定向。false 表示设备因应用了策略而重定向。 |
| denyRule | 如果 isDenied 设置为 true，则此字段很有用。它会告知管理员策略中导致设备未重定向的具体规则集。 |