Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Outil de diagnostic USB

November 25, 2025
Contributeur: 
C

CtxUsbDiagnostics.exe est un outil de ligne de commandes sur le VDA pour aider les administrateurs Citrix à diagnostiquer et à résoudre les problèmes de redirection de périphérique USB rencontrés sur le client de manière accélérée. Cet utilitaire collecte les informations essentielles pour évaluer et prioriser les problèmes de configuration associés aux périphériques USB connectés au client, dont la redirection échoue lors d’une session HDX.

Remarque :

  • L’exécution de l’invite de commandes ou de Powershell en tant qu’administrateur est requise pour garantir que l’outil dispose des autorisations nécessaires pour effectuer des opérations au niveau du système.
  • CtxUsbDiagnostics.exe se trouve dans C:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe. et fait déjà partie des variables d’environnement. Vous n’avez pas besoin d’accéder à ce chemin et pouvez exécuter directement cet outil sur l’invite de commandes avec des privilèges élevés.

Exigences

Hôte de la session

  • Système d’exploitation
    • Windows 10 1809 ou version ultérieure
    • Windows 11 21H2 ou version ultérieure
    • Windows Server 2016 ou version ultérieure
  • VDA
    • Windows : Citrix Virtual Apps and Desktops™ version 2311 ou ultérieure

Machine cliente

  • Système d’exploitation
    • Windows 10 1809 ou version ultérieure
  • Application Workspace
    • Windows : version 2311 ou ultérieure

À quoi sert cet outil ?

L’outil fournit actuellement :

  • SessionID
  • Les stratégies relatives aux périphériques VDA (règles relatives aux périphériques définies dans Studio)
  • Les périphériques clients et stratégies relatives aux périphériques clients (règles relatives aux périphériques)

  • Une liste des périphériques, leur état de redirection et les raisons pour lesquelles ils ont été autorisés ou refusés

    Outil de diagnostic USB

    Remarque :

    L’administrateur peut consulter les informations relatives au périphérique pour toutes les sessions actives.

Informations affichées

  • Règles de Citrix Studio - Version 1/2

    • Les règles DDC indiquent l’utilisation de l’ancienne stratégie « Règles de redirection du périphérique USB client » ou « Règles de redirection du périphérique USB client (version 2) » dans Studio. Les informations répertoriées dans cette section répertorient toutes les règles configurées par l’administrateur Citrix®.

    Règles DDC Version1

  • Règles relatives aux périphériques par défaut du client

    • Cette section répertorie les règles définies dans le registre du client.

    Règles DDC Version 2

  • Règles d’optimisation de périphérique

    • La section répertorie les règles d’optimisation de périphérique définies dans « Règles d’optimisation de périphérique USB client ».

    Règles d'optimisation de périphérique

Liste des périphériques

Cette section répertorie des informations utiles sur chaque périphérique connecté au point de terminaison client, les informations matérielles, s’il est redirigé ou non, si la règle de redirection de périphérique correcte est définie ou non, etc.

Nom de balise Description
displayName Répertorie le nom courant de le périphérique.
vid ID du fournisseur
pid ID du produit
Interfaces Cette sous-section répertorie toutes les interfaces au cas où le périphérique composite aurait été scindé en plusieurs périphériques enfants.
InterfaceNum Index du descripteur d’interface
class Code de classe
subclass Code de sous-classe
protocole Protocole
redirectionState Local indique que le périphérique n’est pas redirigé dans la session ICA®. Thissession indique que le périphérique est redirigé dans la session ICA. OtherSession indique que le périphérique est redirigé vers une autre session ICA.
optiEnabled La valeur true indique que le périphérique est optimisé. La valeur false indique que le périphérique n’est pas optimisé et que le transfert de données s’effectue via le canal virtuel USB.
deviceType La valeur generic indique que le périphérique ne dispose pas d’un canal virtuel optimisé et que le trafic circule via le canal virtuel USB. La valeur optimized implique que le transfert de données associé au périphérique s’effectue via un canal virtuel dédié.
isDenied La valeur true indique que le périphérique n’est pas redirigé en raison d’une règle de stratégie définie par l’administrateur. La valeur false indique que le périphérique est redirigé en raison de la stratégie appliquée.
denyRule Ce champ est utile si isDenied est défini sur true. Il indique à l’administrateur la règle spécifique définie dans la stratégie qui empêche la redirection du périphérique.
Outil de diagnostic USB
November 25, 2025
Contributeur: 
C
November 25, 2025
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.