Citrix Virtual Apps and Desktops 7 2311

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, auf beschleunigte Weise 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:

  • 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-Diagnostic-Tool

    Hinweis:

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

Angezeigte Informationen

  • DDC-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-Rules-Ver1

  • Standard-Client-Geräteregeln

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

    DDC-Rules-Ver2

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äteregel für die Umleitung festgelegt ist oder nicht, usw.

Tag-Name Beschreibung
displayName Listet den allgemeinen 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.
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; die Datenübertragung erfolgt über den virtuellen USB-Kanal.
deviceType generic: Das Gerät hat keinen optimierten virtuellen Kanal, der Datenverkehr fließt über den virtuellen USB-Kanal. optimized impliziert, dass die Datenübertragung für dieses Gerät über einen dedizierten virtuellen Kanal erfolgt.
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 eine Umleitung des Geräts verhindert.
USB-Diagnosetool