Citrix Virtual Apps and Desktops

Strumento di Diagnostica USB

CtxUsbDiagnostics.exe è uno strumento da riga di comando sul VDA per aiutare gli amministratori Citrix a diagnosticare e risolvere in modo rapido i problemi di reindirizzamento dei dispositivi USB riscontrati sul client. Questo strumento di utilità raccoglie informazioni vitali necessarie per la risoluzione dei problemi di configurazione associati ai dispositivi USB collegati al client che non riescono a essere reindirizzati all’interno di una sessione HDX.

> **Nota :**
>
> L'esecuzione di Prompt dei comandi o Powershell come amministratore è necessaria per garantire che lo strumento disponga delle autorizzazioni richieste per eseguire operazioni a livello di sistema.

Requisiti

Host di sessione

  • Sistema operativo
    • Windows 10 1809 o versioni successive
    • Windows 11 21H2 o versioni successive
    • Windows Server 2016 o versioni successive
  • VDA
    • Windows: Citrix Virtual Apps and Desktops™ versione 2311 o successiva

Dispositivo client

  • Sistema operativo
    • Windows 10 1809 o versioni successive
  • Workspace App
    • Windows: versione 2311 o successiva

Cosa fa lo strumento?

Lo strumento attualmente fornisce:

  • SessionID
  • Criteri del dispositivo VDA (regole del dispositivo impostate in Studio)
  • Dispositivi client e criteri del dispositivo client (regole del dispositivo)
  • Elenco dei dispositivi, il loro stato di reindirizzamento e il motivo per cui sono stati consentiti o negati

    USB-Diagnostic-Tool

    Nota :

    L’amministratore può visualizzare le informazioni sul dispositivo per tutte le sessioni attive.

Informazioni Visualizzate

  • Regole di Citrix Studio - Versione 1/2

    • Le regole DDC indicano l’uso dei criteri legacy “Client USB device redirection rules” o “Client USB device redirection rules (Version 2)” in Studio. Le informazioni elencate in questa sezione mostrano tutte le regole configurate dall’amministratore Citrix®.

    DDC-Rules-Ver1

  • Regole predefinite del dispositivo client

    • Questa sezione elenca le regole impostate nel registro sul client.

    DDC-Rules-Ver2

  • Regole di ottimizzazione del dispositivo

    • La sezione elenca le regole di ottimizzazione del dispositivo come impostate in “Client USB device optimization rules”.

    Device Optimization rules

Elenco Dispositivi

Questa sezione elenca informazioni preziose su ogni dispositivo connesso all’endpoint client, le informazioni hardware, se è in fase di reindirizzamento o meno, se la regola di reindirizzamento del dispositivo corretta è impostata o meno e così via.

Tag Name Description
displayName Elenca il nome comune del dispositivo.
vid ID fornitore
pid ID prodotto
Interfaces Questa sottosezione elenca tutte le interfacce nel caso in cui il dispositivo composito sia stato suddiviso in più dispositivi figlio.
InterfaceNum Indica l’indice del descrittore dell’interfaccia
class Codice classe
subclass Codice sottoclasse
protocol Protocollo
redirectionState Local indica che il dispositivo non è reindirizzato nella sessione ICA®. ThisSession indica che il dispositivo è reindirizzato nella sessione ICA. OtherSession indica che il dispositivo è reindirizzato in un’altra sessione ICA.
optiEnabled true indica che il dispositivo è ottimizzato. false indica che il dispositivo non è ottimizzato e il trasferimento dei dati avviene tramite il canale virtuale USB.
deviceType generic indica che il dispositivo non ha un canale virtuale ottimizzato e il traffico fluisce attraverso il canale virtuale USB. optimized implica che il trasferimento dei dati associato al dispositivo avviene tramite un canale virtuale dedicato.
isDenied true indica che il dispositivo non è reindirizzato a causa di una regola di criterio impostata dall’amministratore. false indica che il dispositivo è reindirizzato a causa del criterio applicato.
denyRule Questo campo è utile se isDenied è impostato su true. Indica all’amministratore la regola specifica impostata nel criterio che impedisce il reindirizzamento del dispositivo.
Strumento di Diagnostica USB