Citrix Virtual Apps and Desktops

Strumento di diagnostica USB

January 23, 2026

Grazie al contributo di:

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 vengono reindirizzati 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.exe si trova in C:\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™ versione 2311 o successiva

Dispositivo client

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

Cosa fa lo strumento?

Lo strumento fornisce attualmente:

ID sessione
Criteri dei dispositivi VDA (regole dei dispositivi impostate in Studio)
Dispositivi client e criteri dei dispositivi client (regole dei dispositivi)
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 sui dispositivi 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®.
Regole predefinite dei dispositivi client
- Questa sezione elenca le regole impostate nel registro sul client.
Regole di ottimizzazione dei dispositivi
- La sezione elenca le regole di ottimizzazione dei dispositivi come impostate in “Client USB device optimization rules”.

Elenco dispositivi

Questa sezione elenca informazioni preziose su ogni dispositivo collegato 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.

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	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.

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Strumento di diagnostica USB

January 23, 2026

Grazie al contributo di:

January 23, 2026

Grazie al contributo di:

È stato utile?