产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

USB 诊断工具

March 18, 2026
投稿者: 
C

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 或更高版本

该工具的功能是什么

该工具目前提供：

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

USB 诊断工具

注意：

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

显示的信息

Citrix Studio 规则 - 版本 1/2

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

DDC 规则 - 版本 1

客户端默认设备规则

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

DDC 规则 - 版本 2

设备优化规则

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

设备优化规则

设备列表

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

标签名称 描述
displayName 列出设备的通用名称。
vid 供应商 ID
pid 产品 ID
Interfaces 如果复合设备已拆分为多个子设备，则此子节列出所有接口。
InterfaceNum 指示接口描述符的索引
class 类代码
subclass 子类代码
protocol 协议
redirectionState Local 表示设备未在 ICA® 会话中重定向。ThisSession 表示设备已在 ICA 会话中重定向。OtherSession 表示设备已在另一个 ICA 会话中重定向。
deviceType generic 表示设备没有优化的虚拟通道，流量通过 USB 虚拟通道传输。optimized 表示与设备相关的数据传输正在通过专用虚拟通道进行。
isDenied true 表示设备因管理员设置的策略规则而未重定向。false 表示设备因应用的策略而重定向。
denyRule 如果 isDenied 设置为 true，则此字段很有用。它会告知管理员导致设备未重定向的策略中设置的具体规则。
USB 诊断工具
March 18, 2026
投稿者: 
C
March 18, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.