USB 诊断工具
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 操作系统: 思杰虚拟应用和桌面™ 版本 2311 或更高版本
客户端设备
- 操作系统
- Windows 10 1809 或更高版本
- 工作区应用程序
- Windows: 2311 版或更高版本
该工具的作用
该工具目前提供:
- 会话 ID
- VDA 设备策略(在 Studio 中设置的设备规则)
- 客户端设备和客户端设备策略(设备规则)
-
设备列表、其重定向状态以及允许或拒绝它们的原因

注意:
管理员可以查看所有活动会话的设备信息。
所显示的信息
-
Citrix 工作室规则 - 版本 1/2
- DDC 规则指示在 Studio 中使用了旧版“客户端 USB 设备重定向规则”或“客户端 USB 设备重定向规则(版本 2)”策略。本节中列出的信息列出了 Citrix® 管理员配置的所有规则。

-
客户端默认设备规则
- 本节列出了在客户端注册表中设置的规则。

-
设备优化规则
- 本节列出了“客户端 USB 设备优化规则”中设置的设备优化规则。

设备列表
本节列出了有关连接到客户端端点的每个设备的宝贵信息,包括硬件信息、设备是否正在重定向、以及是否已设置正确的设备重定向规则等。
| 标签名称 | 描述 |
|---|---|
| displayName | 列出设备的通用名称。 |
| vid | 供应商 ID |
| pid | 产品 ID |
| Interfaces | 如果复合设备已拆分为多个子设备,此子部分将列出所有接口。 |
| InterfaceNum | 指示接口描述符的索引 |
| class | 类代码 |
| subclass | 子类代码 |
| protocol | 协议 |
| redirectionState | 本地表示设备未在 ICA® 会话中重定向。此会话表示设备已在 ICA 会话中重定向。其他会话表示设备已在另一个 ICA 会话中重定向。 |
| optiEnabled | true表示设备已优化。false表示设备未优化,数据传输通过 USB 虚拟通道进行。 |
| deviceType | 通用表示设备没有优化的虚拟通道,流量通过 USB 虚拟通道传输。已优化表示与设备相关的数据传输通过专用虚拟通道进行。 |
| isDenied |
true表示设备因管理员设置的策略规则而未重定向。false表示设备因应用的策略而重定向。 |
| denyRule | 如果 isDenied 设置为 true,此字段很有用。它会告知管理员策略中导致设备未重定向的特定规则集。 |
USB 诊断工具
已复制!
失败!