Citrix Virtual Apps and Desktops

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 Operationen besitzt.
  • CtxUsbDiagnostics.exe befindet sich unter C:\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 (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

    USB-Diagnosetool

    Hinweis:

    Der Administrator kann Geräteinformationen für alle aktiven Sitzungen einsehen.

Angezeigte Informationen

  • Citrix Studio-Regeln – Version 1/2

    • Die DDC-Regeln zeigen die Verwendung der älteren Richtlinie „Client-USB-Geräteumleitungsregeln“ oder „Client-USB-Geräteumleitungsregeln (Version 2)“ in Studio an. Die in diesem Abschnitt aufgeführten Informationen listen alle vom Citrix®-Administrator konfigurierten Regeln auf.

    DDC-Regeln-Ver1

  • Standard-Geräteregeln des Clients

    • Dieser Abschnitt listet die Regeln auf, die in der Registrierung auf dem Client festgelegt sind.

    DDC-Regeln-Ver2

  • Geräteoptimierungsregeln

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

    Geräteoptimierungsregeln

Geräteliste

Dieser Abschnitt listet wertvolle Informationen zu jedem Gerät auf, das mit dem Client-Endpunkt verbunden ist, einschließlich Hardwareinformationen, ob es umgeleitet wird oder nicht, ob die korrekte Geräteregel für die Umleitung festgelegt ist oder nicht, und so weiter.

Tag-Name Beschreibung
displayName Listet den gebräuchlichen Namen des Geräts auf.
vid Hersteller-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 Lokal bedeutet, dass das Gerät nicht in der ICA®-Sitzung umgeleitet wird. DieseSitzung bedeutet, dass das Gerät in der ICA-Sitzung umgeleitet wird. AndereSitzung bedeutet, dass das Gerät in einer anderen ICA-Sitzung umgeleitet wird.
deviceType Generisch bedeutet, dass das Gerät keinen optimierten virtuellen Kanal besitzt und der Datenverkehr über den virtuellen USB-Kanal fließt. Optimiert bedeutet, dass die Datenübertragung, die mit dem Gerät verbunden ist, über einen dedizierten virtuellen Kanal erfolgt.
isDenied true bedeutet, dass das Gerät aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet wird. false bedeutet, dass das Gerät aufgrund der angewendeten Richtlinie umgeleitet wird.
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.
USB-Diagnosetool