Outil de diagnostic USB
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 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 commande 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.exese trouve dansC:\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 commande 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
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 « Client USB device redirection rules » ou « Client USB device redirection rules (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 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 d’optimisation des périphériques
- Cette section répertorie les règles d’optimisation des périphériques telles que définies dans « Client USB 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 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 : le périphérique n’est pas redirigé dans la session ICA®. ThisSession : le périphérique est redirigé dans la session ICA. OtherSession : le périphérique est redirigé dans une autre session ICA. |
| optiEnabled | true : le périphérique est optimisé. false : le périphérique n’est pas optimisé et le transfert de données s’effectue via le canal virtuel USB. |
| deviceType | generic : le périphérique ne dispose pas d’un canal virtuel optimisé et le trafic transite par le canal virtuel USB. optimized : le transfert de données associé au périphérique s’effectue via un canal virtuel dédié. |
| isDenied |
true : le périphérique n’est pas redirigé en raison d’une règle de stratégie définie par l’administrateur. false : 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. |