USB-Diagnosetool
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 in einer HDX-Sitzung nicht umgeleitet werden können.
Hinweis:
- Das Ausführen der Eingabeaufforderung oder von PowerShell als Administrator ist erforderlich, um sicherzustellen, dass das Tool die notwendigen Berechtigungen für systemweite Vorgänge besitzt.
CtxUsbDiagnostics.exebefindet sich inC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe. und ist bereits Teil der Umgebungsvariablen. Sie müssen nicht zu diesem Pfad navigieren und können dieses Tool direkt in der Eingabeaufforderung mit erhöhten Rechten ausführen.
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:
- Session-ID
- VDA-Geräterichtlinien (in Studio festgelegte Geräteregeln)
- Clientgeräte und Clientgeräterichtlinien (Geräteregeln)
-
Liste der Geräte, deren Umleitungsstatus und warum sie zugelassen oder verweigert wurden

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.

-
Standard-Geräteregeln für Clients
- Dieser Abschnitt listet die Regeln auf, die in der Registrierung auf dem Client festgelegt sind.

-
Regeln zur Geräteoptimierung
- Der Abschnitt listet die Regeln zur Geräteoptimierung auf, wie sie in „Client-USB-Geräteoptimierungsregeln“ festgelegt sind.

Geräteliste
Dieser Abschnitt listet wertvolle Informationen zu jedem mit dem Client-Endpunkt verbundenen Gerät auf, die Hardwareinformationen, ob es umgeleitet wird oder nicht, ob die korrekte Geräteredirektionsregel festgelegt ist oder nicht und so weiter.
| Tag-Name | Beschreibung |
|---|---|
| displayName | Listet den gebräuchlichen Namen des Geräts auf. |
| vid | Anbieter-ID |
| pid | Produkt-ID |
| Interfaces | Dieser Unterabschnitt listet alle Schnittstellen auf, falls das zusammengesetzte Gerät in mehrere untergeordnete Geräte aufgeteilt wurde. |
| InterfaceNum | Gibt den Index des Schnittstellendeskriptors an |
| class | Klassencode |
| subclass | Unterklassencode |
| protocol | Protokoll |
| redirectionState | Local: Das Gerät wird nicht in der ICA®-Sitzung umgeleitet. ThisSession: Das Gerät wird in der ICA-Sitzung umgeleitet. OtherSession: Das Gerät wird in einer anderen ICA-Sitzung umgeleitet. |
| deviceType | generisch: Das Gerät verfügt über keinen optimierten virtuellen Kanal, und der Datenverkehr fließt über den virtuellen USB-Kanal. optimiert: Die Datenübertragung des Geräts erfolgt über einen dedizierten virtuellen Kanal. |
| isDenied |
true: Das Gerät wird aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet. false: Das Gerät wird aufgrund einer angewendeten Richtlinie umgeleitet. |
| denyRule | Dieses Feld ist nützlich, wenn isDenied auf true gesetzt ist. Es informiert den Administrator über die spezifische Richtlinienregel, die die Umleitung des Geräts verhindert. |