Citrix DaaS™

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 que ocorrem no cliente de forma acelerada. Esta ferramenta de utilitário 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

    Ferramenta de Diagnóstico USB

    Observação:

    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 do cliente” ou “Regras de redirecionamento de dispositivo USB do cliente (Versão 2)” no Studio. As informações listadas nesta seção mostram todas as regras configuradas pelo administrador Citrix®.

Regras DDC - Ver1

Regras Padrão de Dispositivo Cliente

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

Regras DDC - Ver2

Regras de otimização de dispositivo

A seção lista as regras de otimização de dispositivo conforme definido em “Regras de otimização de dispositivo USB do cliente”.

Regras de otimização de dispositivo

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.

Tag Name Description
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 múltiplos 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 está sendo redirecionado na sessão ICA®. ThisSession indica que o dispositivo está sendo redirecionado na sessão ICA. OtherSession indica que o dispositivo está sendo 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 está sendo redirecionado devido a uma regra de política definida pelo administrador. false indica que o dispositivo está sendo 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.
Ferramenta de Diagnóstico USB