Documentación de productos
Citrix Virtual Apps and Desktops
Servicio Versión actual 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Herramienta de diagnóstico USB

September 3, 2026
Contribución de: 
C C

CtxUsbDiagnostics.exe es una herramienta de línea de comandos en el VDA para ayudar a los administradores de Citrix a diagnosticar y resolver problemas de redirección de dispositivos USB experimentados en el cliente de manera expedita. Esta 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 del sistema.
  • CtxUsbDiagnostics.exe se encuentra en C:\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
  • Workspace App
    • 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

    USB-Diagnostic-Tool

    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 “Client USB device redirection rules” o “Client USB device redirection rules (Version 2)” en Studio. La información que aparece en esta sección enumera todas las reglas configuradas por el administrador de Citrix®.

    DDC-Rules-Ver1

  • Reglas de dispositivo predeterminadas del cliente

    • Esta sección enumera las reglas configuradas en el registro del cliente.

    DDC-Rules-Ver2

  • Reglas de optimización de dispositivos

    • Esta sección enumera las reglas de optimización de dispositivos tal como se establecen en “Client USB device optimization rules”.

    Device Optimization rules

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á configurada o no, y así sucesivamente.

Nombre de etiqueta Descripción
displayName Enumera el nombre común del dispositivo.
ID de proveedor ID de proveedor
ID de producto 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
clase Código de clase
subclase Código de subclase
protocolo Protocolo
redirectionState Local indica que el dispositivo no se redirige en la sesión de ICA®. ThisSession indica que el dispositivo se redirige en la sesión de ICA. OtherSession indica que el dispositivo se redirige en otra sesión de ICA.
deviceType genérico indica que el dispositivo no tiene un canal virtual optimizado y el tráfico fluye a través del canal virtual USB. optimizado implica que la transferencia de datos asociada al dispositivo 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 el dispositivo 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.
deviceDriver Este campo indica si hay un controlador correspondiente presente o no en el host VDI.

Además, se incluye una sección de resumen para cada dispositivo que permite al usuario conocer la disponibilidad del dispositivo dentro de la sesión HDX.

Recomendaciones

Esta sección proporciona un breve resumen de las diversas reglas y problemas de los dispositivos (si los hay) que deben corregirse o investigarse.

Herramienta de diagnóstico USB
September 3, 2026
Contribución de: 
C C
September 3, 2026
Contribución de: 
C C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.