Citrix Virtual Apps and Desktops

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: Citrix Virtual Apps and Desktops™ 版本 2311 或更高版本

客户端设备

  • 操作系统
    • Windows 10 1809 或更高版本
  • Workspace 应用程序
    • Windows: 2311 版或更高版本

该工具的作用?

该工具目前提供:

  • SessionID
  • VDA 设备策略(在 Studio 中设置的设备规则)
  • 客户端设备和客户端设备策略(设备规则)
  • 设备列表、其重定向状态以及允许或拒绝它们的原因

    USB 诊断工具

    注意:

    管理员可以查看所有活动会话的设备信息。

显示的信息

  • Citrix Studio 规则 - 版本 1/2

    • DDC 规则表示在 Studio 中使用了旧版“客户端 USB 设备重定向规则”或“客户端 USB 设备重定向规则(版本 2)”策略。本节中列出的信息列出了由 Citrix® 管理员配置的所有规则。

    DDC 规则 - 版本 1

  • 客户端默认设备规则

    • 本节列出了在客户端注册表中设置的规则。

    DDC 规则 - 版本 2

  • 设备优化规则

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

    设备优化规则

设备列表

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

标签名称 描述
displayName 列出设备的通用名称。
供应商 ID 供应商 ID
产品 ID 产品 ID
接口 本小节列出了所有接口,以防复合设备已拆分为多个子设备。
InterfaceNum 指示接口描述符的索引
类代码
子类 子类代码
协议 协议
redirectionState 本地表示设备未在 ICA® 会话中重定向。此会话表示设备在此 ICA 会话中重定向。其他会话表示设备在其他 ICA 会话中重定向。
deviceType generic 表示设备没有优化的虚拟通道,流量通过 USB 虚拟通道传输。optimized 表示与设备相关的数据传输正在通过专用虚拟通道进行。
isDenied true 表示设备因管理员设置的策略规则而未重定向。false 表示设备因应用的策略而重定向。
denyRule 此字段在 isDenied 设置为 true 时很有用。它会告知管理员策略中导致设备未重定向的具体规则集。
deviceDriver 此字段指示 VDI 主机上是否存在相应的驱动程序。

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

建议

本节简要概述了需要纠正或调查的各种设备规则和问题(如果有)。

USB 诊断工具