Citrix Virtual Apps and Desktops

Ferramenta de Diagnóstico USB

January 23, 2026

Contribuição de:

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 enfrentados no cliente de forma acelerada. Esta ferramenta utilitária coleta informações vitais necessárias para triar problemas de configuração associados a dispositivos USB conectados ao cliente que não estão sendo redirecionados dentro de uma sessão HDX.

> **Observação :**
>
> É necessário executar o Prompt de Comando ou o Powershell como administrador para garantir que a ferramenta tenha as permissões necessárias para realizar operações em nível de sistema.

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

Observação :

O administrador pode ver 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 “Client USB device redirection rules” ou “Client USB device redirection rules (Version 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 do 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 de interface
class	Código de Classe
subclass	Código de Subclasse
protocolo	Protocolo
redirectionState	Local indica que o dispositivo não é redirecionado na sessão ICA®. ThisSession indica que o dispositivo é redirecionado na sessão ICA. OtherSession indica que o dispositivo é redirecionado em outra sessão ICA.
optiEnabled	true indica que o dispositivo está otimizado. false indica que o dispositivo não está otimizado e a transferência de dados ocorre pelo canal virtual USB.
deviceType	generic indica que o dispositivo não possui um canal virtual otimizado e o tráfego está fluindo pelo 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.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Ferramenta de Diagnóstico USB

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Isso foi útil?