产品文档
Citrix DaaS™
查看 PDF

USB 诊断工具

May 4, 2026
投稿者: 
C C

CtxUsbDiagnostics.exe 是 VDA 上的一个命令行工具，旨在帮助 Citrix 管理员快速诊断和解决客户端上遇到的 USB 设备重定向问题。此实用工具收集了对排查与连接到客户端的 USB 设备相关的配置问题至关重要的信息，这些设备在 HDX 会话中无法重定向。

注意：

运行命令提示符或 PowerShell 时需要以管理员身份运行，以确保该工具具有执行系统级操作所需的权限。

要求

会话主机 

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

客户端设备

  • 操作系统
    • Windows 10 1809 或更高版本
  • Workspace App
    • Windows：2311 版或更高版本

该工具的作用是什么

该工具目前提供：

  • SessionID
  • VDA 设备策略（在 Studio 中设置的设备规则）
  • 客户端设备和客户端设备策略（设备规则）
    • 设备列表、它们的重定向状态以及允许或拒绝重定向的原因
  • USB 诊断工具

注意：

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

显示的信息 

-  **Citrix Studio 规则 - 版本 1/2**

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

![DDC 规则版本 1](/en-us/citrix-daas/media/ddc-rules-ver1.png)

-  **客户端默认设备规则**

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

![DDC 规则版本 2](/en-us/citrix-daas/media/ddc-rules-ver2.png)

  • 设备优化规则

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

    设备优化规则

设备列表

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

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

在本文中

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