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

USB 诊断工具

September 20, 2024
投稿者: 
C

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

> **Note :**
>
> Running Command Prompt or Powershell as an administrator is required to ensure the tool has the necessary permissions to perform system-level operations.

要求

会话主机

  • 操作系统
    • 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-Diagnostic-Tool

    注意：

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

显示的信息

  • Citrix Studio 规则 - 版本 1/2

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

    DDC-Rules-Ver1

  • 客户端默认设备规则

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

    DDC-Rules-Ver2

  • 设备优化规则

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

    设备优化规则

设备列表

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

标记名称 说明
displayName 列出设备的公用名。
vid 供应商 ID
pid 产品 ID
接口 本小节内容列出了将复合设备拆分为多个子设备时使用的所有接口。
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 诊断工具
September 20, 2024
投稿者: 
C
September 20, 2024
投稿者: 
C

在本文中

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