Ferramenta de Diagnóstico USB
CtxUsbDiagnostics.exe é uma ferramenta de linha de comando no VDA para ajudar os administradores Citrix a diagnosticar e resolver problemas de redirecionamento de dispositivos USB experimentados no cliente de forma expedita. Esta ferramenta de utilidade coleta informações vitais necessárias para triar problemas de configuração associados a dispositivos USB conectados ao cliente que não estão conseguindo redirecionar dentro de uma sessão 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 sessão
- Sistema operacional
- Windows 10 1809 ou posterior
- Windows 11 21H2 ou posterior
- Windows Server 2016 ou posterior
- VDA
- Windows: Citrix Virtual Apps and Desktops™ Versão 2311 ou posterior
Dispositivo cliente
- Sistema operacional
- Windows 10 1809 ou posterior
- Workspace App
- Windows: versão 2311 ou posterior
O que a ferramenta faz?
A ferramenta atualmente fornece:
- SessionID
- Políticas de dispositivo VDA (regras de dispositivo definidas no Studio)
- Dispositivos cliente e políticas de dispositivo cliente (regras de dispositivo)
-
Lista de dispositivos, seu estado de redirecionamento e por que foram permitidos ou negados
Nota :
O administrador pode ver as informações do dispositivo para todas as sessões ativas.
Informações Exibidas
-
Regras do Citrix Studio - Versão 1/2
- As regras DDC indicam o uso da política legada “Regras de redirecionamento de dispositivo USB cliente” ou “Regras de redirecionamento de dispositivo USB cliente (Versão 2)” no Studio. As informações listadas nesta seção listam todas as regras configuradas pelo administrador Citrix®.
-
Regras Padrão de Dispositivo Cliente
- Esta seção lista as regras que são definidas no registro no cliente.
-
Regras de otimização de dispositivo
- A seção lista as regras de otimização de dispositivo conforme definido em “Client USB device optimization rules.”
Lista de Dispositivos
Esta seção lista informações valiosas sobre cada dispositivo conectado ao endpoint do cliente, as informações de hardware, se está sendo redirecionado ou não, se a regra de redirecionamento de dispositivo correta está definida ou não, e assim por diante.
| Nome da Tag | Descrição |
|---|---|
| displayName | Lista o nome comum do dispositivo. |
| vid | ID do Fornecedor |
| pid | ID do Produto |
| Interfaces | Esta subseção lista todas as interfaces caso o dispositivo composto tenha sido dividido em vários dispositivos filhos. |
| InterfaceNum | Indica o índice do descritor da interface |
| class | Código da Classe |
| subclass | Código da Subclasse |
| protocol | Protocolo |
| redirectionState | Local indica que o dispositivo não é redirecionado na sessão ICA®. ThisSession indica o redirecionamento do dispositivo na sessão ICA. OtherSession aponta para o redirecionamento do dispositivo em outra sessão ICA. |
| optiEnabled | true indica que o dispositivo está otimizado. false significa que o dispositivo não está otimizado e a transferência de dados ocorre através do canal virtual USB. |
| deviceType | generic indica que o dispositivo não possui um canal virtual otimizado e o tráfego está fluindo através do canal virtual USB. optimized implica que a transferência de dados associada ao dispositivo está ocorrendo por um canal virtual dedicado. |
| isDenied |
true indica que o dispositivo não é redirecionado devido a uma regra de política definida pelo administrador. false indica que o dispositivo é redirecionado devido à política aplicada. |
| denyRule | Este campo é útil se isDenied estiver definido como true. Ele informa ao administrador a regra específica definida na política que está impedindo o redirecionamento do dispositivo. |