Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Configuração

January 23, 2026
Contribuição de: 
C

O redirecionamento USB é desabilitado por padrão. Você pode configurar o redirecionamento USB genérico usando as seguintes configurações na política do Citrix®:

  • Redirecionamento de dispositivo USB do cliente: para habilitar ou desabilitar o redirecionamento USB
  • Regras de redirecionamento de dispositivo USB do cliente: para especificar ações específicas do dispositivo, 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 filtragem, divisão e conexão automática de 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 novos dispositivos USB 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 de Política USB para obter mais detalhes.

Como configurar o redirecionamento USB

Por padrão, a configuração de redirecionamento USB é desabilitada. Para usá-la, 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 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”.

Criando Regras de Política de Redirecionamento USB

Quando a pessoa tenta redirecionar um dispositivo USB para o Virtual Desktop, ele é verificado em relação a 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 terá permissão para 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 dispositivos USB comuns, as regras de dispositivo definidas na política ou na configuração do aplicativo Citrix Workspace™ do cliente no endpoint 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 endpoints. 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 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. 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 início 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 de Dispositivo

Definindo a política no DDC:

  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 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: Allow: VID=056A PID=00A4 #STU-430 Deny: Class=08 subclass=05 # Mass Storage

    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 em versões mais recentes do CVAD e do CWA.

Para configuração legada de dispositivos USB, consulte Configuração de Redirecionamento USB Legado.

Configurar o redirecionamento automático de dispositivos USB (Opcional)

Os 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 os dispositivos USB. Nem sempre é melhor redirecionar todos os dispositivos USB. As pessoas podem redirecionar explicitamente dispositivos da lista de dispositivos USB que não são redirecionados automaticamente. Para evitar que os dispositivos USB sejam listados ou redirecionados, use as DeviceRules no endpoint 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 definidas para permitir o redirecionamento automático de dispositivos USB:

  • Permitir que dispositivos USB existentes sejam conectados automaticamente

  • Permitir que novos dispositivos USB sejam conectados automaticamente

    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 configuração “Permitir que dispositivos USB existentes sejam conectados automaticamente”.

    4. Desmarque a caixa de seleção “Usar valor padrão” e selecione “Redirecionar automaticamente dispositivos USB disponíveis” no menu suspenso e clique em “Salvar”.

    5. Edite a configuração “Permitir que novos dispositivos USB sejam conectados automaticamente”.

    6. Desmarque a caixa de seleção “Usar valor padrão” e selecione “Redirecionar automaticamente dispositivos USB disponíveis” no menu suspenso e clique em “Salvar”.

Entendendo as Regras de Redirecionamento de Dispositivo USB

Ao usar o redirecionamento USB do Cliente Citrix, é importante entender como as 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, vêm 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 verifica as regras definidas nesta configuração de política. Novamente, se uma regra para um dispositivo for encontrada aqui, ela será 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 as Regras de redirecionamento de dispositivo USB do cliente (Versão 2) não estiverem definidas no Studio ou se a versão do Citrix Workspace App para 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 recorre às regras configuradas por meio de 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 de empresas tempo para planejar o caminho de migração para a configuração de política de regras de dispositivo da Versão 2 mais avançada 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 uma regra definida como 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 cliente, o sistema primeiro avaliará as regras na política do Studio 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.

Configuração
January 23, 2026
Contribuição de: 
C
January 23, 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.