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 in 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.
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:
- SessionID
- VDA-Geräterichtlinien (Geräteregeln, die in Studio festgelegt wurden)
- Clientgeräte und Client-Gerä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-Client-Geräteregeln
- 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 korrekte 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 bedeutet: Das Gerät wird nicht in der ICA®-Sitzung umgeleitet. ThisSession zeigt an: Das Gerät wird in der ICA-Sitzung umgeleitet. OtherSession gibt an: Das Gerät wird in einer anderen ICA-Sitzung umgeleitet. |
| optiEnabled | true bedeutet, das Gerät ist optimiert. false bedeutet, das Gerät ist nicht optimiert und die Datenübertragung erfolgt über den virtuellen USB-Kanal. |
| deviceType | generic bedeutet, das Gerät hat keinen optimierten virtuellen Kanal und der Datenverkehr fließt über den virtuellen USB-Kanal. optimized impliziert, dass die mit dem Gerät verbundene Datenübertragung über einen dedizierten virtuellen Kanal erfolgt. |
| isDenied |
true bedeutet, das Gerät wird aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet. false zeigt an, 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 Regel in der Richtlinie, die dazu führt, dass das Gerät nicht umgeleitet wird. |