Documentation produit
Citrix Virtual Apps and Desktops
Service Version actuelle 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Voir PDF

Outil de diagnostic USB

September 1, 2026
Contributeur: 
C C

CtxUsbDiagnostics.exe est un outil en ligne de commande sur le VDA pour aider les administrateurs Citrix à diagnostiquer et à résoudre rapidement les problèmes de redirection de périphériques USB rencontrés sur le client. Cet outil utilitaire recueille des informations vitales nécessaires pour trier les problèmes de configuration associés aux périphériques USB connectés au client qui ne parviennent pas à être redirigés dans 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 de naviguer vers ce chemin et pouvez exécuter directement cet outil sur l’invite de commandes avec des privilèges élevés.

Configuration requise

Hôte de 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

Périphérique client

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

Que fait l’outil ?

L’outil fournit actuellement :

  • SessionID
  • Stratégies de périphérique VDA (règles de périphérique définies dans Studio)
  • Périphériques clients et stratégies de périphérique client (règles de périphérique)

  • Liste des périphériques, leur état de redirection et la raison pour laquelle ils ont été autorisés ou refusés

    USB-Diagnostic-Tool

    Remarque :

    L’administrateur peut consulter les informations sur les périphériques pour toutes les sessions actives.

Informations affichées

  • Règles Citrix Studio - Version 1/2

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

    DDC-Rules-Ver1

  • Règles de périphérique par défaut du client

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

    DDC-Rules-Ver2

  • Règles d’optimisation des périphériques

    • Cette section répertorie les règles d’optimisation des périphériques telles que définies dans « Règles d’optimisation des périphériques USB du client ».

    Device Optimization rules

Liste des périphériques

Cette section répertorie des informations précieuses 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, et ainsi de suite.

Nom de balise Description
displayName Répertorie le nom commun du périphérique.
ID fournisseur ID du fournisseur
ID produit ID produit
Interfaces Cette sous-section répertorie toutes les interfaces au cas où le périphérique composite aurait été divisé en plusieurs périphériques enfants.
InterfaceNum Indique l’index du descripteur d’interface
classe Code de classe
sous-classe 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é dans une autre session ICA.
deviceType generic indique que l’appareil ne dispose pas d’un canal virtuel optimisé et que le trafic transite par le canal virtuel USB. optimized implique que le transfert de données associé à l’appareil s’effectue via un canal virtuel dédié.
isDenied true indique que l’appareil n’est pas redirigé en raison d’une règle de stratégie définie par l’administrateur. false indique que l’appareil 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 entraîne la non-redirection de l’appareil.
deviceDriver Ce champ indique si un pilote correspondant est présent ou non sur l’hôte VDI.

De plus, une section récapitulative est incluse pour chaque appareil, informant l’utilisateur de la disponibilité de l’appareil au sein de la session HDX.

Recommandations

Cette section fournit un bref résumé des différentes règles et problèmes (le cas échéant) liés aux appareils qui doivent être corrigés ou examinés.

Outil de diagnostic USB
September 1, 2026
Contributeur: 
C C
September 1, 2026
Contributeur: 
C 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.