Herramienta de diagnóstico USB
CtxUsbDiagnostics.exe es una herramienta de línea de comandos en el VDA para ayudar a los administradores de Citrix a diagnosticar y resolver de forma acelerada los problemas de redirección de dispositivos USB experimentados en el cliente. Esta herramienta de utilidad recopila información vital necesaria para clasificar los problemas de configuración asociados con los dispositivos USB conectados al cliente que no se redirigen dentro de una sesión HDX.
Nota:
- Es necesario ejecutar el Símbolo del sistema o Powershell como administrador para garantizar que la herramienta tenga los permisos necesarios para realizar operaciones a nivel de sistema.
CtxUsbDiagnostics.exese encuentra enC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe. y ya forma parte de las variables de entorno. No es necesario navegar a esta ruta y puede ejecutar directamente esta herramienta en el símbolo del sistema con privilegios elevados.
Requisitos
Host de sesión
- Sistema operativo
- Windows 10 1809 o posterior
- Windows 11 21H2 o posterior
- Windows Server 2016 o posterior
- VDA
- Windows: Citrix Virtual Apps and Desktops™ Versión 2311 o posterior
Dispositivo cliente
- Sistema operativo
- Windows 10 1809 o posterior
- Aplicación Workspace
- Windows: versión 2311 o posterior
¿Qué hace la herramienta?
Actualmente, la herramienta proporciona:
- SessionID
- Directivas de dispositivos VDA (reglas de dispositivos configuradas en Studio)
- Dispositivos cliente y directivas de dispositivos cliente (reglas de dispositivos)
-
Lista de dispositivos, su estado de redirección y por qué se permitieron o denegaron
Nota :
El administrador puede ver la información del dispositivo para todas las sesiones activas.
Información mostrada
-
Reglas de Citrix Studio - Versión 1/2
- Las reglas de DDC indican el uso de la directiva heredada “Reglas de redirección de dispositivos USB de cliente” o “Reglas de redirección de dispositivos USB de cliente (Versión 2)” en Studio. La información que aparece en esta sección enumera todas las reglas configuradas por el administrador de Citrix®.
-
Reglas predeterminadas de dispositivos de cliente
- Esta sección enumera las reglas establecidas en el registro del cliente.
-
Reglas de optimización de dispositivos
- La sección enumera las reglas de optimización de dispositivos tal como se establecen en “Reglas de optimización de dispositivos USB de cliente”.
Lista de dispositivos
Esta sección enumera información valiosa sobre cada dispositivo conectado al punto final del cliente, la información de hardware, si se está redirigiendo o no, si la regla de redirección de dispositivo correcta está establecida o no, y así sucesivamente.
| Nombre de etiqueta | Descripción |
|---|---|
| displayName | Enumera el nombre común del dispositivo. |
| vid | ID de proveedor |
| pid | ID de producto |
| Interfaces | Esta subsección enumera todas las interfaces en caso de que el dispositivo compuesto se haya dividido en varios dispositivos secundarios. |
| InterfaceNum | Indica el índice del descriptor de interfaz |
| class | Código de clase |
| subclass | Código de subclase |
| protocol | Protocolo |
| redirectionState | Local indica que el dispositivo no se redirige en la sesión de ICA®. ThisSession indica que se redirige en la sesión de ICA. OtherSession indica que se redirige en otra sesión de ICA. |
| optiEnabled | true indica que el dispositivo está optimizado. false indica que no lo está y que la transferencia de datos se realiza a través del canal virtual USB. |
| deviceType | generic indica que el dispositivo no tiene un canal virtual optimizado y el tráfico fluye a través del canal virtual USB. optimized implica que la transferencia de datos asociada a este se realiza a través de un canal virtual dedicado. |
| isDenied |
true indica que el dispositivo no se redirige debido a una regla de directiva establecida por el administrador. false indica que se redirige debido a la directiva aplicada. |
| denyRule | Este campo es útil si isDenied está establecido en true. Informa al administrador de la regla específica establecida en la directiva que impide la redirección del dispositivo. |