Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço 2607 LTSR Versão Atual 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Ferramenta de Diagnóstico USB

September 15, 2026
Contribuição de: 
C

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 sendo redirecionados dentro de uma sessão HDX.

Nota :

  • É 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 de nível de sistema.
  • CtxUsbDiagnostics.exe está localizado em C:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe. e já faz parte das variáveis de ambiente. Você não precisa navegar para este caminho e pode executar diretamente esta ferramenta no prompt de comando com privilégios elevados.

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
  • Aplicativo Workspace
    • 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

    Ferramenta de Diagnóstico USB

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

    DDC-Rules-Ver1

  • Regras Padrão de Dispositivo do Cliente

    • Esta seção lista as regras que são definidas no registro do cliente.

    DDC-Rules-Ver2

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

    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.
ID do fornecedor ID do Fornecedor
ID do produto ID do Produto
Interfaces Esta subseção lista todas as interfaces caso o dispositivo composto tenha sido dividido em vários dispositivos filho.
InterfaceNum Indica o índice do descritor da interface
classe Código da Classe
subclasse Código da 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.
deviceType genérico indica que o dispositivo não possui um canal virtual otimizado e o tráfego está fluindo através do canal virtual USB. otimizado 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á resultando no não redirecionamento do dispositivo.
deviceDriver Este campo indica se um driver correspondente está presente ou não no host VDI.

Além disso, uma seção de resumo é incluída para cada dispositivo, que informa ao usuário a disponibilidade do dispositivo dentro da sessão HDX.

Recomendações

Esta seção fornece um breve resumo das várias regras e problemas de dispositivo (se houver) que precisam ser corrigidos ou investigados.

Ferramenta de Diagnóstico USB
September 15, 2026
Contribuição de: 
C
September 15, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.