Configuração

Last published : Nov 13, 2026
O redirecionamento USB está desabilitado por padrão. Você pode configurar o redirecionamento USB genérico usando as seguintes configurações na política Citrix®:
  • Redirecionamento de dispositivo USB do cliente: para habilitar ou desabilitar o redirecionamento USB
  • Regras de redirecionamento de dispositivo USB do cliente: para especificar uma ação de dispositivo específica, ou seja, para permitir ou negar acesso a um dispositivo específico
  • Regras de redirecionamento de dispositivo USB do cliente (Versão 2): para especificar regras para filtrar, dividir e conectar automaticamente dispositivos USB
  • Regras de otimização de dispositivo USB do cliente: para desabilitar a otimização ou alterar o modo de otimização
  • Permitir que dispositivos USB existentes sejam conectados automaticamente: para permitir ou impedir a conexão automática de dispositivos USB existentes que estão conectados a um endpoint cliente no início de uma sessão HDX™
  • Permitir que dispositivos USB recém-chegados sejam detectados automaticamente: para permitir ou impedir a conexão automática de dispositivos USB que são conectados a um endpoint cliente durante uma sessão HDX
Consulte, Configurações da Política USB para obter mais detalhes.
Related information
Dispositivos USB

Como configurar o redirecionamento USB

Por padrão, a configuração de redirecionamento USB está desabilitada. Para usá-lo, a política de redirecionamento USB e as regras de redirecionamento específicas devem ser habilitadas e configuradas no DDC.
Observação:
Se você estiver usando componentes anteriores à versão 2212 ou estiver usando o Workspace App para Linux/Mac, consulte Configuração de Redirecionamento USB Legado para obter detalhes sobre como configurar o redirecionamento USB.

Habilitando o Redirecionamento USB Genérico

  1. Abra as políticas do Citrix Web Studio™ e clique na guia Políticas.
  2. Clique em Criar Política e expanda as políticas ICA® > Dispositivos USB.
  3. Edite a política de redirecionamento de dispositivo USB do cliente.
  4. Selecione Permitido e clique em Salvar.

Criação de regras de política de redirecionamento USB

Quando o usuário tenta redirecionar um dispositivo USB para o Virtual Desktop, ele é verificado em cada regra de política USB, uma por uma, até que uma correspondência seja encontrada. A primeira correspondência para qualquer dispositivo é considerada final. Se a primeira correspondência for uma regra de Permitir, o dispositivo correspondente pode ser redirecionado para o desktop virtual. Se a primeira correspondência for uma regra de Negar, o dispositivo correspondente estará disponível apenas no desktop local. Se nenhuma correspondência for encontrada, as regras padrão serão usadas.

Regras de dispositivo

Assim como acontece com os dispositivos USB regulares, as regras de dispositivo definidas na política ou na configuração do aplicativo cliente Citrix Workspace™ no ponto de extremidade selecionam os dispositivos para encaminhamento. O aplicativo Citrix Workspace usa essas regras para decidir quais dispositivos USB permitir ou impedir de serem encaminhados para a sessão remota.
Cada regra consiste em uma palavra-chave de ação (Permitir, Conectar ou Negar), dois pontos (:), e zero ou mais parâmetros de filtro que correspondem a dispositivos reais no subsistema USB dos pontos de extremidade. Esses parâmetros de filtro correspondem aos metadados do descritor de dispositivo USB usados por cada dispositivo USB para se identificar.
As regras de dispositivo são de texto simples, com cada regra em uma única linha e um comentário opcional após um caractere #. As regras são correspondidas de cima para baixo (ordem de prioridade decrescente). A primeira regra que corresponde ao dispositivo ou interface filha é aplicada. As regras subsequentes que selecionam o mesmo dispositivo ou interface são ignoradas.
Exemplo: ALLOW: VID=1050 PID=0421 #Device1 Exemplo: CONNECT: VID=xxxx PID=yyyy Class=03 #Device2
Palavra-chave Descrição
CONNECT Use esta palavra-chave para permitir que os dispositivos sejam redirecionados pelo canal virtual USB, bem como para habilitá-los a serem redirecionados automaticamente durante o lançamento da sessão e na inserção.
ALLOW Use esta palavra-chave para permitir que os dispositivos sejam redirecionados pelo canal virtual USB
DENY Use esta palavra-chave para negar que os dispositivos sejam redirecionados pelo canal virtual USB
Regras_do_Dispositivo
Definindo a política no DDC:
  1. Abra políticas do Citrix Web Studio e clique na guia Políticas.
  2. Clique em Criar Política e expanda as políticas ICA > Dispositivos USB.
  3. Edite as regras de redirecionamento de dispositivo USB do cliente (Versão 2).
  4. Defina o valor com base nos exemplos fornecidos na descrição para cada dispositivo USB que precisa ser redirecionado e clique em Salvar.
    Por Exemplo: Permitir: VID=056A PID=00A4 #STU-430 Negar: Class=08 subclass=05 # Armazenamento em Massa
    Observação:
    Se um administrador Citrix marcar Usar valor padrão e clicar em Salvar, as regras padrão podem ser encontradas no seguinte registro no VDA.
    Cuidado!
    Consulte o Aviso Legal no final deste artigo antes de usar o Editor do Registro.
    HKLM\SOFTWARE\Wow6432Node\Citrix\PortICA\GenericUSB\DeviceRules
Observação:
As políticas ainda podem ser definidas no dispositivo cliente usando regras de dispositivo de política de grupo, mas isso não é mais necessário nas versões mais recentes do CVAD e do CWA.
Para configuração legada de dispositivos USB, consulte Configuração de Redirecionamento USB Legado.

Configurar redirecionamento automático de dispositivos USB (Opcional)

Dispositivos USB são redirecionados automaticamente quando o suporte USB está habilitado. Além disso, as configurações de preferência do usuário USB são definidas para conectar automaticamente dispositivos USB. Nem sempre é melhor redirecionar todos os dispositivos USB. Os usuários podem redirecionar explicitamente dispositivos da lista de dispositivos USB que não são redirecionados automaticamente. Para evitar que dispositivos USB sejam listados ou redirecionados, use DeviceRules no endpoint do cliente ou na política do DDC. Esta política pode ser definida no DDC, no cliente usando um GPO, usando as Preferências do Citrix Workspace ou a guia Conexões em CDViewer. Todos esses métodos são descritos abaixo:
Definindo a política no DDC:
Existem duas políticas no DDC que podem ser configuradas para permitir o redirecionamento automático de dispositivos USB-
  • Permitir que dispositivos USB existentes sejam conectados automaticamente
  • Permitir que dispositivos USB recém-chegados sejam conectados automaticamente
    1. Abra Citrix Web Studio policies e clique na guia Policies.
    2. Clique em Create Policy e expanda as ICA > USB Devices policies.
    3. Edite a configuração Allow existing USB devices to be automatically connected.
    4. Desmarque a caixa de seleção Use default value e selecione Automatically redirect available USB devices no menu suspenso e clique em Save.
    5. Edite a configuração Allow newly arrived USB devices to be automatically connected.
    6. Desmarque a caixa de seleção Use default value e selecione Automatically redirect available USB devices no menu suspenso e clique em Save.

Compreendendo as Regras de Redirecionamento de Dispositivos USB

Ao usar o redirecionamento USB do Citrix Client, é importante entender como diferentes regras são priorizadas e aplicadas. Pense nisso como um conjunto de instruções: o sistema verifica as regras em uma ordem específica, e a primeira regra que ele encontra para um dispositivo específico é a que prevalece. Quaisquer outras regras para esse mesmo dispositivo encontradas mais adiante na lista são então ignoradas.
Aqui está a ordem em que suas regras de dispositivo são avaliadas:
  • Regras de redirecionamento de dispositivo USB do cliente (Versão 2): As regras de dispositivo configuradas por esta configuração de política recebem a mais alta prioridade. Se uma regra para um dispositivo específico for encontrada aqui, essa regra será aplicada, e nenhuma outra regra para esse dispositivo em particular será considerada.
  • Regras de redirecionamento de dispositivo USB do cliente: Em seguida, estão as regras definidas nesta configuração legada dentro do Citrix Studio. Se nenhuma regra para um dispositivo foi encontrada na política da Versão 2, o sistema então verifica as regras definidas nesta configuração de política. Novamente, se uma regra para um dispositivo for encontrada aqui, ela é aplicada, e o sistema para de procurar regras para esse dispositivo específico.
    Observação:
    A configuração de política acima é aplicada apenas se Regras de redirecionamento de dispositivo USB do cliente (Versão 2) não estiver definida no Studio ou se a versão do Citrix Workspace App for Windows for anterior a 2212.
  • Objetos de Política de Grupo (GPOs) do lado do cliente: Se um dispositivo ainda não tiver uma regra aplicada após verificar ambas as configurações de política do Studio, o sistema então se remete às regras configuradas via Objetos de Política de Grupo do lado do cliente.
  • Configurações de Registro do lado do cliente: Finalmente, as configurações de registro do lado do cliente são aplicadas como a prioridade mais baixa.
Essa hierarquia garante que configurações mais específicas ou mais recentes tenham precedência para um determinado dispositivo, fornecendo uma maneira clara e previsível de gerenciar o redirecionamento de dispositivos USB. É importante lembrar que, embora a hierarquia determine a ordem de avaliação, uma regra encontrada para um dispositivo em um nível superior impedirá que as regras para esse mesmo dispositivo sejam aplicadas em níveis inferiores. No entanto, as regras definidas em níveis inferiores não são completamente ignoradas; elas ainda são avaliadas para quaisquer dispositivos que ainda não tiveram uma regra aplicada.
Essa abordagem em camadas também garante a compatibilidade retroativa. Ao atualizar de versões mais antigas do Citrix Virtual Apps and Desktops™ ou do aplicativo Citrix Workspace, as configurações existentes do lado do cliente serão preservadas. Isso dá aos administradores corporativos tempo para planejar o caminho de migração para a configuração de política mais avançada de regras de dispositivo da Versão 2 no Studio, sem interrupção imediata.
Exemplo:
Digamos que você tenha um dispositivo USB específico com ID de Fornecedor (VID) xxxx e ID de Produto (PID) yyyy.
  • Na sua configuração de política Regras de redirecionamento de dispositivo USB do cliente (Versão 2) no Citrix Studio, você tem um conjunto de regras CONNECT VID=xxxx PID=yyyy.
  • Separadamente, em um Objeto de Política de Grupo (GPO) do lado do cliente, você tem uma regra DENY para o mesmo dispositivo DENY: VID=xxxx PID=yyyy.
Quando este dispositivo é conectado ao endpoint do cliente, o sistema primeiro avaliará as regras na política do Studio da Versão 2. Ele encontra a regra CONNECT VID=xxxx PID=yyyy. Como esta regra está no nível de precedência mais alto, ela é aplicada imediatamente. O sistema então ignora quaisquer outras regras para este dispositivo específico. Portanto, mesmo que uma regra DENY exista em um GPO do lado do cliente, ela será ignorada, e o dispositivo será redirecionado com sucesso.