Strumento di diagnostica USB
CtxUsbDiagnostics.exe è uno strumento da riga di comando sul VDA per aiutare gli amministratori Citrix a diagnosticare e risolvere i problemi di reindirizzamento dei dispositivi USB riscontrati sul client in modo rapido. 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 reindirizzare all’interno di una sessione HDX.
Nota :
- È necessario eseguire il prompt dei comandi o PowerShell come amministratore per garantire che lo strumento disponga delle autorizzazioni necessarie per eseguire operazioni a livello di sistema.
CtxUsbDiagnostics.exesi trova inC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe. ed è già parte delle variabili d’ambiente. Non è necessario navigare a questo percorso e si può eseguire direttamente questo strumento dal prompt dei comandi con privilegi elevati.
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™ Version 2311 o versioni successive
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

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 “Regole di reindirizzamento del dispositivo USB client” o “Regole di reindirizzamento del dispositivo USB client (Versione 2)” in Studio. Le informazioni elencate in questa sezione elencano tutte le regole configurate dall’amministratore Citrix®.

-
Regole predefinite del dispositivo client
- Questa sezione elenca le regole impostate nel registro sul client.

-
Regole di ottimizzazione del dispositivo
- La sezione elenca le regole di ottimizzazione del dispositivo come impostate in “Regole di ottimizzazione del dispositivo USB client”.

Elenco dispositivi
Questa sezione elenca informazioni preziose su ciascun dispositivo connesso all’endpoint client, le informazioni hardware, se viene reindirizzato o meno, se la regola di reindirizzamento del dispositivo corretta è impostata o meno e così via.
| Nome tag | Descrizione |
|---|---|
| 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 | Locale indica che il dispositivo non viene reindirizzato nella sessione ICA®. QuestaSessione indica che il dispositivo viene reindirizzato nella sessione ICA. AltraSessione indica che il dispositivo viene reindirizzato in un’altra sessione ICA. |
| deviceType | generico indica che il dispositivo non dispone di un canale virtuale ottimizzato e che il traffico fluisce attraverso il canale virtuale USB. ottimizzato implica che il trasferimento dei dati associato al dispositivo avviene su un canale virtuale dedicato. |
| isDenied |
true indica che il dispositivo non viene reindirizzato a causa di una regola di policy impostata dall’amministratore. false indica che il dispositivo viene reindirizzato a causa della policy applicata. |
| denyRule | Questo campo è utile se isDenied è impostato su true. Indica all’amministratore la regola specifica impostata nella policy che impedisce il reindirizzamento del dispositivo. |