USB-Diagnosetool
CtxUsbDiagnostics.exe ist ein Befehlszeilentool auf dem VDA, das Citrix-Administratoren dabei hilft, Probleme bei der Umleitung von USB-Geräten, 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 über die notwendigen Berechtigungen für Systemoperationen verfügt.
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 Folgendes:
- Session-ID
- VDA-Geräterichtlinien (Geräteregeln, die in Studio festgelegt wurden)
- 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 anzeigen.
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 des Clients
- Dieser Abschnitt listet die Regeln auf, die in der Registrierung auf dem Client festgelegt sind.

-
Geräteoptimierungsregeln
- Dieser Abschnitt listet die Geräteoptimierungsregeln auf, wie sie in „Client-USB-Geräteoptimierungsregeln“ festgelegt sind.

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. |
| 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 | generic – das Gerät hat keinen optimierten virtuellen Kanal und der Datenverkehr fließt über den virtuellen USB-Kanal. optimized – die mit dem Gerät verbundene Datenübertragung 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 der 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. |