USB-Diagnosetool

Last published : Nov 03, 2026
CtxUsbDiagnostics.exe ist ein Befehlszeilentool auf dem VDA, das Citrix-Administratoren dabei hilft, Probleme bei der USB-Geräteumleitung, die auf dem Client auftreten, schnell zu diagnostizieren und zu beheben. Dieses Dienstprogramm sammelt wichtige Informationen, die zur Behebung von Konfigurationsproblemen im Zusammenhang mit USB-Geräten erforderlich sind, die an den Client angeschlossen sind und nicht innerhalb einer HDX-Sitzung umgeleitet werden können.
> **Note :**
>
> Running Command Prompt or Powershell as an administrator is required to ensure the tool has the necessary permissions to perform system-level operations.
Related information
USB-Geräte

Anforderungen

Sitzungshost

  • Betriebssystem
    • Windows 10 1809 oder höher
    • Windows 11 21H2 oder höher
    • Windows Server 2016 oder höher
  • VDA
    • Windows: Citrix Virtual Apps and Desktops™ Version 2311 oder höher

Clientgerät

  • Betriebssystem
    • Windows 10 1809 oder höher
  • Workspace App
    • Windows: Version 2311 oder höher

Was leistet das Tool?

Das Tool bietet derzeit:
  • SessionID
  • VDA-Geräterichtlinien (Geräteregeln, die in Studio festgelegt sind)
  • Clientgeräte und Client-Geräterichtlinien (Geräteregeln)
  • Liste der Geräte, deren Umleitungsstatus und warum sie zugelassen oder verweigert wurden
    USB-Diagnostic-Tool
    Hinweis:
    Der Administrator kann Geräteinformationen für alle aktiven Sitzungen einsehen.

Angezeigte Informationen

  • Citrix Studio-Regeln – Version 1/2
    • Die DDC-Regeln weisen auf die Verwendung der älteren Richtlinie „Client-USB-Geräteumleitungsregeln“ oder „Client-USB-Geräteumleitungsregeln (Version 2)“ in Studio hin. Die in diesem Abschnitt aufgeführten Informationen listen alle vom Citrix®-Administrator konfigurierten Regeln auf.
    DDC-Rules-Ver1
  • Standard-Client-Geräteregeln
    • Dieser Abschnitt listet die Regeln auf, die in der Registrierung auf dem Client festgelegt sind.
    DDC-Rules-Ver2
  • Geräteoptimierungsregeln
    • Dieser Abschnitt listet die Geräteoptimierungsregeln auf, wie sie in "Client-USB-Geräteoptimierungsregeln" festgelegt sind.
    Geräteoptimierungsregeln

Geräteliste

Dieser Abschnitt listet wertvolle Informationen zu jedem Gerät auf, das mit dem Client-Endpunkt verbunden ist, die Hardwareinformationen, ob es umgeleitet wird oder nicht, ob die richtige Geräteumleitungsregel festgelegt ist oder nicht und so weiter.
Tag-Name Beschreibung
displayName Listet den gebräuchlichen Namen des Geräts auf.
Hersteller-ID Hersteller-ID
Produkt-ID Produkt-ID
Schnittstellen Dieser Unterabschnitt listet alle Schnittstellen auf, falls das zusammengesetzte Gerät in mehrere untergeordnete Geräte aufgeteilt wurde.
InterfaceNum Gibt den Index des Schnittstellen-Deskriptors an
Klasse Klassencode
Unterklasse Unterklassencode
Protokoll Protokoll
redirectionState Local gibt an, dass das Gerät nicht in der ICA®-Sitzung umgeleitet wird. ThisSession gibt an, dass das Gerät in der ICA-Sitzung umgeleitet wird. OtherSession gibt an, dass das Gerät in einer anderen ICA-Sitzung umgeleitet wird.
optiEnabled true gibt an, dass das Gerät optimiert ist. false gibt an, dass das Gerät nicht optimiert ist und die Datenübertragung über den virtuellen USB-Kanal erfolgt.
deviceType generic gibt an, dass das Gerät keinen optimierten virtuellen Kanal hat und der Datenverkehr über den virtuellen USB-Kanal fließt. optimized bedeutet, dass die mit dem Gerät verbundene Datenübertragung über einen dedizierten virtuellen Kanal erfolgt.
isDenied true gibt an, dass das Gerät aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet wird. false gibt an, dass das Gerät aufgrund der angewendeten Richtlinie umgeleitet wird.
denyRule Dieses Feld ist nützlich, wenn isDenied auf true gesetzt ist. Es informiert den Administrator über die spezifische Regel in der Richtlinie, die dazu führt, dass das Gerät nicht umgeleitet wird.