Citrix Virtual Apps and Desktops

Herramienta de diagnóstico USB

CtxUsbDiagnostics.exe es una herramienta de línea de comandos del VDA que ayuda a los administradores de Citrix a diagnosticar y resolver de forma rápida los problemas de redirección de dispositivos USB que se producen en el cliente. Esta herramienta recopila la información más importante necesaria para clasificar los problemas de configuración asociados a los dispositivos USB conectados al cliente que no se redirigen dentro de una sesión HDX.

> **Note :**
>
> Running Command Prompt or Powershell as an administrator is required to ensure the tool has the necessary permissions to perform system-level operations.

Requisitos

Host de la sesión

  • Sistema operativo
    • Windows 10 1809 o una versión posterior
    • Windows 11 21H2 o posterior
    • Windows Server 2016 o una versión posterior
  • VDA
    • Windows: Citrix Virtual Apps and Desktops, versión 2311 o posterior

Dispositivo cliente

  • Sistema operativo
    • Windows 10 1809 o una versión posterior
  • Aplicación Workspace
    • Windows: versión 2311 o posterior

¿Para qué sirve la herramienta?

La herramienta actualmente proporciona:

  • SessionID
  • Directivas de dispositivos de VDA (reglas de dispositivo definidas en Studio)
  • Dispositivos cliente y directivas de dispositivos cliente (reglas de dispositivos)
  • Lista de dispositivos, su estado de redirección y motivos por los que se permitieron o rechazaron

    Herramienta de diagnóstico USB

    Nota:

    El administrador puede ver la información de los dispositivos para todas las sesiones activas.

Información mostrada

  • Reglas de Citrix Studio: Versión 1/2

    • Las reglas de DDC indican el uso de las directivas antiguas Reglas de redirección de dispositivos USB del cliente o Reglas de redirección de dispositivos USB del cliente (versión 2) en Studio. La información que aparece en esta sección muestra todas las reglas configuradas por el administrador de Citrix.

    DDC-Rules-Ver1

  • Reglas de dispositivo predeterminadas del cliente

    • En esta sección se enumeran las reglas que se establecen en el Registro del cliente.

    DDC-Rules-Ver2

  • Reglas de optimización de dispositivos

    • La sección enumera las reglas de optimización del dispositivo tal como se establece en “Reglas de optimización de dispositivos USB del cliente”.

    Reglas de optimización de dispositivos

Lista de dispositivos

En esta sección se incluye información valiosa sobre cada dispositivo que está conectado al dispositivo de punto final del cliente, la información del hardware, si se redirige o no, si se estableció la regla de redirección de dispositivos correcta o no, etc.

Nombre de la etiqueta Descripción
displayName Muestra el nombre común del dispositivo.
vid ID de proveedor
pid ID del producto
Interfaces En esta subsección se enumeran todas las interfaces en caso de que el dispositivo compuesto se haya dividido en varios dispositivos secundarios.
InterfaceNum Indica el índice del descriptor de la interfaz
class Código de clase
subclass Código de subclase
protocolo Protocolo
redirectionState Localindica que el dispositivo no se redirige en la sesión ICA. ThisSessionindica que el dispositivo se redirige en la sesión ICA. OtherSessionindica que el dispositivo se redirige en otra sesión ICA.
optiEnabled trueindica que el dispositivo está optimizado. false indica que el dispositivo no está optimizado y que la transferencia de datos se realiza a través del canal virtual USB.
deviceType genérico indica que el dispositivo no tiene un canal virtual optimizado y que 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 trueindica 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 se establece en true. Le indica al administrador la regla específica establecida en la directiva que hace que el dispositivo no se redirija.
Herramienta de diagnóstico USB