Citrix Virtual Apps and Desktops

USB 诊断工具

CtxUsbDiagnostics.exe 为 VDA 上的命令行工具,可帮助 Citrix 管理员快速诊断和解决客户端上遇到的 USB 设备重定向问题。此实用工具收集解决与连接到客户端的 USB 设备无法在 HDX 会话内重定向有关的配置问题所需的重要信息。

要求

会话主机

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

客户端设备

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

此工具有何功能

此工具当前提供:

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

    USB-Diagnostic-Tool

    注意:

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

显示的信息

  • DDC 规则 - 版本 1/2

    • DDC 规则表明在 Studio 中使用的是旧版客户端 USB 设备重定向规则客户端 USB 设备重定向规则(版本 2) 策略。本部分中列出的信息列出了 Citrix 管理员配置的所有规则。

    DDC-Rules-Ver1

  • 客户端默认设备规则

    • 本部分内容列出了在客户端上的注册表中设置的规则。

    DDC-Rules-Ver2

设备列表

本部分内容列出了与连接到客户端端点的每台设备有关的宝贵信息、硬件信息、是否正在重定向、是否设置了正确的设备重定向规则等等。

标记名称 说明
displayName 列出设备的公用名。
vid 供应商 ID
pid 产品 ID
接口 本小节内容列出了将复合设备拆分为多个子设备时使用的所有接口。
redirectionState Local 表示设备未在 ICA 会话中重定向。ThisSession 表示设备在 ICA 会话中被重定向。OtherSession 表示设备在另一个 ICA 会话中被重定向。
optiEnabled true 表示设备已优化。false 表示设备未优化,数据传输通过 USB 虚拟通道进行。
deviceType generic 表示设备没有优化的虚拟通道,流量通过 USB 虚拟通道传输。optimized 意味着与设备关联的数据传输是通过专用虚拟通道进行的。
isDenied true 表示设备由于管理员设置的策略规则而未重定向。false 表示设备由于应用的策略而被重定向。
denyRule 如果 isDenied 设置为 true,则此字段非常有用。它告诉管理员在策略中设置的导致设备无法重定向的特定规则。
USB 诊断工具