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 nicht innerhalb einer HDX-Sitzung 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 sind)
- 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 für Clients
- Dieser Abschnitt listet die Regeln auf, die in der Registrierung auf dem Client festgelegt sind.
-
Geräteoptimierungsregeln
- Der Abschnitt listet die Geräteoptimierungsregeln auf, wie sie in „Client-USB-Geräteoptimierungsregeln“ festgelegt sind.
Geräteliste
Dieser Abschnitt listet wichtige Informationen zu jedem Gerät auf, das mit dem Clientendpunkt verbunden ist, die Hardwareinformationen, ob es umgeleitet wird oder nicht, ob die korrekte Geräteregel 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 Schnittstellen-Deskriptors 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. |
| optiEnabled | true: Das Gerät ist optimiert. false: Das Gerät ist nicht optimiert, und die Datenübertragung erfolgt über den virtuellen USB-Kanal. |
| deviceType | generic: Das Gerät verfügt über keinen optimierten virtuellen Kanal, und der Datenverkehr fließt über den virtuellen USB-Kanal. optimized: 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 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 dazu führt, dass das Gerät nicht umgeleitet wird. |