Citrix Virtual Apps and Desktops

Solução de problemas

January 23, 2026

Contribuição de:

Siga as etapas abaixo para solucionar problemas relacionados ao redirecionamento USB:

Valide se os requisitos do sistema para o redirecionamento USB estão sendo atendidos. Isso inclui as versões corretas do CVAD e do CWA, dispositivos compatíveis e drivers de dispositivo na plataforma do sistema operacional em questão.
Certifique-se de que a configuração seja apropriada com base nas versões e plataformas dos componentes em uso no seu ambiente. Consulte a nota em Configuração de Redirecionamento USB Legado para obter detalhes sobre os componentes que exigem configurações de redirecionamento legado.
Valide se o dispositivo está listado entre os dispositivos que o cliente enumerou.
1. Barra de ferramentas de Preferências do Workspace: Verifique os dispositivos enumerados na guia “Dispositivos” da barra de ferramentas de Preferências do aplicativo Workspace (clique com o botão direito do mouse no ícone do CWA > Central de Conexão > Preferências… Clique na guia “Dispositivos”).
2. CtxUsbDiagnostics.exe (Recomendado): Execute esta ferramenta em uma janela de prompt de comando. A saída fornece informações específicas do dispositivo para uma sessão específica. Ela informará se um dispositivo está sendo redirecionado ou não. Também informará se um conjunto de regras de dispositivo está impedindo o redirecionamento do dispositivo. Consulte Ferramenta de Diagnóstico para obter mais informações.
3. USBView ou outras ferramentas de terceiros: Execute uma ferramenta de terceiros como o USBView na máquina do endpoint/cliente para garantir que o dispositivo seja detectado no endpoint.
Se o dispositivo for enumerado:
1. Se você vir uma regra de negação na saída da ferramenta CtxUsbDiagnostics para um dispositivo específico, verifique as políticas configuradas no Studio e certifique-se de que as regras estejam definidas corretamente na política da Versão 2. Se a regra de negação não aparecer na política do Studio, verifique a política do lado do cliente e, por fim, os padrões do lado do cliente, nessa ordem, para encontrar a regra de negação correspondente.
2. Se não houver uma regra de negação na saída do CtxUsbDiagnostics, o CWA permitirá o redirecionamento do dispositivo marcando/clicando no botão apropriado na guia “Dispositivos” da janela “Preferências” (Dispositivos > Gerenciar dispositivos). Um dispositivo, uma vez redirecionado, estará disponível na sessão. Isso pode ser verificado consultando o gerenciador de dispositivos/USBView ou aplicativo similar na sessão HDX.
Se o dispositivo não for apresentado dentro da sessão:
1. É possível que o driver de dispositivo correto não esteja instalado corretamente no host VDA. Certifique-se de que as versões mais recentes dos drivers de dispositivo estejam instaladas corretamente no host VDA. Alguns drivers de dispositivo não são compatíveis com máquinas de servidor de terminal, portanto, certifique-se de que não seja esse o caso com o dispositivo que você está tentando redirecionar.
2. Certifique-se de que o dispositivo não esteja sendo usado no endpoint do cliente. Alguns dispositivos exigem que os drivers sejam instalados também no endpoint do cliente, e isso pode impedir que eles sejam redirecionados na sessão.
Valide se as regras relacionadas ao USB estão definidas corretamente no endpoint do cliente:
1. CWA para Windows:
  1. Valide se a política de grupo no cliente (adicione mais detalhes e capturas de tela para isso) está definida de forma apropriada e não entra em conflito com as regras definidas no Studio.
  2. Valide as regras padrão no registro do cliente.
  (HKLM\SOFTWARE\Wow6432Node\Citrix\PortICA\GenericUSB\DeviceRules) estão definidas de forma apropriada e não entram em conflito com as regras definidas no Studio e na política de grupo do cliente.
2. CWA para Linux - Para solucionar problemas do CWA para Linux, consulte a documentação USB para CWA para Linux
3. CWA para Mac - Para solucionar problemas do CWA para Mac, consulte CWA para Mac

Nota:

Em TSVDA, os dispositivos de áudio são bloqueados por padrão de usar o redirecionamento USB. A maneira recomendada de usar esses dispositivos é utilizando o VC de Áudio otimizado.

Às vezes, dispositivos USB compostos podem não ser divididos automaticamente, mesmo que uma regra de redirecionamento de dispositivo correta esteja definida para dividir o dispositivo. Esse problema ocorre porque o dispositivo está em modo de baixo consumo de energia. Nessas instâncias, o dispositivo filho que entra no modo de baixo consumo de energia pode não estar presente na lista de dispositivos. Você pode usar as seguintes soluções alternativas para superar esse problema:

Desconecte a sessão, insira o dispositivo USB e reconecte-se à sessão.

Desconecte o dispositivo USB e conecte-o novamente. Essa ação faz com que o dispositivo saia do modo de baixo consumo de energia.

Às vezes, as configurações de economia de bateria USB podem ser ativadas para otimizar a vida útil da bateria. Se o endpoint do cliente entrar em suspensão, o dispositivo USB poderá ser desconectado. Nesse cenário, talvez seja necessário desconectar e reconectar o dispositivo para apresentá-lo novamente na sessão.

Logs de Eventos

Os administradores agora podem monitorar dispositivos não autorizados que os usuários podem tentar redirecionar e tomar as medidas apropriadas. Aqui estão algumas das mensagens de evento que serão registradas no Visualizador de Eventos no host VDA para dispositivos que têm permissão para serem redirecionados e para dispositivos que não têm.

Event_Log1

Event_Log2

Event_Log3

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?

Solução de problemas

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Neste artigo

Logs de Eventos

Isso foi útil?