Citrix Virtual Apps and Desktops

USB-Diagnosetool

November 25, 2025

Beitrag von:

CtxUsbDiagnostics.exe ist ein Befehlszeilentool auf dem VDA, mit dem Citrix-Administratoren Probleme mit der USB-Geräteumleitung auf dem Client schneller diagnostizieren und lösen können. Dieses Hilfsprogramm sammelt wichtige Informationen, die zur Priorisierung von Konfigurationsproblemen im Zusammenhang mit an den Client angeschlossenen USB-Geräten erforderlich sind, die innerhalb einer HDX-Sitzung nicht umgeleitet werden können.

Hinweis :

Um sicherzustellen, dass das Tool über die erforderlichen Berechtigungen zum Ausführen von Vorgängen auf Systemebene verfügt, müssen Sie die Eingabeaufforderung oder Powershell als Administrator ausführen.

CtxUsbDiagnostics.exe befindet sich in C:\Programme\Citrix\HDX\bin\CtxUsbDiagnostics.exe und ist bereits Teil der Umgebungsvariablen. Sie müssen nicht zu diesem Pfad navigieren und können dieses Tool mit erhöhten Rechten direkt in der Eingabeaufforderung 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 macht das Tool?

Das Tool bietet derzeit:

SessionID
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 geben die Verwendung der veralteten Richtlinie “Regeln für die Client-USB-Geräteumleitung” oder “Regeln für die Client-USB-Geräteumleitung (Version 2)” in Studio an. Die in diesem Abschnitt aufgeführten Informationen listen alle vom Citrix®-Administrator konfigurierten Regeln auf.
Standardgeräteregeln für Clients
- In diesem Abschnitt werden die Regeln aufgeführt, die in der Registrierung auf dem Client festgelegt sind.
Regeln zur Geräteoptimierung
- In diesem Abschnitt werden die Regeln zur Geräteoptimierung aufgeführt, wie sie unter “Regeln zur Optimierung von Client-USB-Geräten” festgelegt sind.

Geräteliste

Dieser Abschnitt enthält wichtige Informationen zu jedem mit dem Clientendpunkt verbundenen Gerät, zur Hardware, zu eventuell vorhandenen Umleitungen, zur Einhaltung einer gegebenenfalls festgelegten Geräteumleitungsregel und so weiter.

Tagname	Beschreibung
displayName	Listet den allgemeinen Namen des Geräts auf.
vid	Anbieter-ID
pid	Produkt-ID
Interfaces	In diesem Unterabschnitt werden alle Schnittstellen für den Fall aufgeführt, dass das Verbundgerät in mehrere untergeordnete Geräte aufgeteilt wurde.
InterfaceNum	Gibt den Index des Schnittstellendeskriptors an
class	Klassencode
subclass	Unterklassencode
Protokoll	Protokoll
redirectionState	Local zeigt an, dass das Gerät in der ICA®-Sitzung nicht 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 zeigt an, dass das Gerät optimiert ist. false zeigt an, dass das Gerät nicht optimiert ist und die Datenübertragung über den virtuellen USB-Kanal erfolgt.
deviceType	generisch zeigt 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 zeigt an, dass das Gerät aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet wird. `false` zeigt an, dass das Gerät aufgrund der angewendeten Richtlinie umgeleitet wird.
denyRule	Dieses Feld ist nützlich, wenn isDenied auf true gesetzt ist. Es teilt dem Administrator die spezifische Regel mit, die in der Richtlinie festgelegt ist und dazu führt, dass das Gerät nicht umgeleitet wird.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

USB-Diagnosetool

November 25, 2025

Beitrag von:

November 25, 2025

Beitrag von:

War dieser Artikel hilfreich?