Citrix DaaS™

Outil de diagnostic USB

April 6, 2026

Contributeur:

C C

CtxUsbDiagnostics.exe est un outil en ligne de commande sur le VDA qui aide les administrateurs Citrix à diagnostiquer et à résoudre rapidement les problèmes de redirection de périphériques USB rencontrés sur le client. Cet utilitaire recueille les informations essentielles 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.

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 :

ID de session
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

Remarque :

L’administrateur peut afficher 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ériques USB clients** » ou « **Règles de redirection de périphériques USB clients (Version 2)** » dans Studio. Les informations répertoriées dans cette section listent toutes les règles configurées par l'administrateur Citrix®.

![Règles DDC - Version 1](/en-us/citrix-daas/media/ddc-rules-ver1.png)

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

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

![Règles DDC - Version 2](/en-us/citrix-daas/media/ddc-rules-ver2.png)

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 clients ».

![Règles d'optimisation des périphériques](/en-us/citrix-daas/media/usb-dev-optimization.png)

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 la balise	Description
displayName	Répertorie le nom commun du 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é divisé en plusieurs périphériques enfants.
InterfaceNum	Indique l’index du descripteur d’interface
class	Code de classe
subclass	Code de sous-classe
protocol	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.
optiEnabled	true indique que le périphérique est optimisé. 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	generic indique que le périphérique 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é au périphérique s’effectue via un canal virtuel dédié.
isDenied	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. `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.

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Outil de diagnostic USB

April 6, 2026

Contributeur:

C C

April 6, 2026

Contributeur:

C C