Citrix Virtual Apps and Desktops

USB-Diagnosetool

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.

> **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 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

    USB-Diagnostic-Tool

    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 enthalten alle Regeln, die vom Citrix-Administrator konfiguriert wurden.

    DDC-Rules-Ver1

  • Standardgeräteregeln für Clients

    • In diesem Abschnitt werden die Regeln aufgeführt, die in der Registrierung auf dem Client festgelegt sind.

    DDC-Rules-Ver2

  • 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.

    Regeln zur Geräteoptimierung

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 gibt 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 gibt an, dass das Gerät optimiert ist. false bedeutet, dass das Gerät nicht optimiert ist und die Datenübertragung über den virtuellen USB-Kanal erfolgt.
deviceType generic gibt 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 gibt an, dass das Gerät aufgrund einer vom Administrator festgelegten Richtlinienregel nicht umgeleitet wird. false bedeutet, dass das Gerät aufgrund einer 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.
USB-Diagnosetool