Citrix Virtual Apps and Desktops 7 2402 LTSR

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 erforderlich sind, die mit an den Client angeschlossenen USB-Geräten verbunden sind, die 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 sind)
  • 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 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.

    DDC-Regeln-Ver1

  • Standard-Client-Geräteregeln

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

    DDC-Rules-Ver2

  • Geräteoptimierungsregeln

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

    Device Optimization rules

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äteredirektionsregel 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 Lokal: 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 mit dem Gerät verbundene Datenübertragung erfolgt über einen dedizierten virtuellen Kanal.
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