Skip to main content

6 de enero de 2026

Establecer las propiedades de configuración USB

Puede establecer las propiedades de configuración USB en los archivos de configuración.

Utilice la siguiente sintaxis para establecer las propiedades de configuración USB en los archivos de configuración.

viewusb.property1 = "value1"

Con las propiedades de configuración USB, puede controlar si se redireccionarán ciertos tipos de dispositivos. El filtrado de propiedades también está disponible para permitirle incluir o excluir ciertos tipos de dispositivos. También hay propiedades para dividir dispositivos compuestos.

Algunos valores de propiedades requieren el VID (ID del proveedor) y el PID (ID del producto) de un dispositivo USB. Para encontrar el VID y el PID, puede realizar una búsqueda en Internet con el nombre del producto combinado con vid y pid.

En la siguiente tabla se describen las propiedades de configuración USB disponibles.

Propiedades de configuración para el redireccionamiento USB
Nombre de directiva y propiedadDescripción
Permitir la división automática del dispositivo Propiedad: viewusb.AllowAutoDeviceSplittingPermite la división automática de dispositivos USB compuestos. El valor predeterminado no está definido, lo que equivale a false.
Excluir el dispositivo Vid/Pid de la división Propiedad: viewusb.SplitExcludeVidPidExcluye un dispositivo USB compuesto especificado mediante los ID de producto y proveedor procedentes de la división. El formato de la configuración es vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]... Debe especificar los números de ID en hexadecimal. Puede utilizar el carácter comodín (*) en lugar de dígitos individuales en un ID. Por ejemplo: vid-0781_pid-55** El valor predeterminado no está definido.
Dividir un dispositivo Vid/Pid Propiedad: viewusb.SplitVidPidTrata los componentes de un dispositivo USB compuesto especificado por los ID del producto y del proveedor como dispositivos distintos. El formato de la configuración es vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww ]])[;...] Puede usar la palabra clave exintf para excluir componentes del redireccionamiento al especificar el número de interfaz. Debe especificar números ID de forma hexadecimal. Además, los números de interfaz en decimales deben incluir un cero a la izquierda. Puede utilizar el carácter comodín (*) en lugar de dígitos individuales en un ID. Por ejemplo: vid-0781_pid-554c(exintf:01;exintf:02) Nota: Si el dispositivo compuesto incluye componentes que se excluyen automáticamente, como los dispositivos de mouse y teclado, Horizon Client no incluirá de forma automática los componentes que no excluyera explícitamente. Debe especificar una directiva de filtrado, como Incluir dispositivo Vid/Pid para incluir estos componentes. El valor predeterminado no está definido.
Permitir dispositivos de entrada de audio Propiedad: viewusb.AllowAudioInPermite que se redireccionen los dispositivos de entrada de audio. El valor predeterminado no está definido, lo que equivale al valor false, ya que la función Audio/vídeo en tiempo real se usa en los dispositivos de entrada y salida de audio y, de forma predeterminada, no se usa el redireccionamiento USB para dichos dispositivos.
Permitir dispositivos de salida de audio Propiedad: viewusb.AllowAudioOutPermite que se redireccionen los dispositivos de salida de audio. El valor predeterminado no está definido, lo que equivale a false.
Permitir HID Propiedad: viewusb.AllowHIDPermite que se redireccionen otros dispositivos de entrada que no sean un teclado o un mouse. El valor predeterminado no está definido, lo que equivale a true.
Permitir dispositivos HID de arranque Propiedad: viewusb.AllowHIDBootablePermite que se redireccionen otros dispositivos de entrada que no sean dispositivos de teclado o de mouse y que estén disponibles en el momento del arranque (también denominados dispositivos con arranque HID). El valor predeterminado no está definido, lo que equivale a true.
Permitir descriptor de dispositivo protegido contra fallos Propiedad: viewusb.AllowDevDescFailsafePermite el redireccionamiento de dispositivos aunque Horizon Client no pueda obtener los descriptores de dispositivos o configuración. Para permitir un dispositivo aunque se produzca un error en la configuración o la descripción, es necesario que aparezca en los filtros de incluidos como IncludeVidPid o IncludePath. El valor predeterminado no está definido, lo que equivale a false.
Permitir dispositivos de teclado y mouse Propiedad: viewusb.AllowKeyboardMousePermite que se redireccionen teclados con dispositivos señaladores integrados (como un mouse, bola de seguimiento o panel táctil). El valor predeterminado no está definido, lo que equivale a false.
Permitir tarjetas inteligentes Propiedad: viewusb.AllowSmartcardPermite que se redireccionen los dispositivos de tarjeta inteligente. El valor predeterminado no está definido, lo que equivale a false.
Permitir dispositivos de vídeo Propiedad: viewusb.AllowVideoPermite que se redireccionen los dispositivos de vídeo. El valor predeterminado no está definido, lo que equivale al valor false, ya que la función Audio/vídeo en tiempo real se usa en los dispositivos de entrada y salida de audio y, de forma predeterminada, no se usa el redireccionamiento USB para dichos dispositivos.
Deshabilitar la descarga de configuración remota Propiedad: viewusb.DisableRemoteConfigNo permite el uso de la configuración Horizon Agent al realizar el filtrado de dispositivos USB. El valor predeterminado no está definido, lo que equivale a false.
Excluir todos los dispositivos Propiedad: viewusb.ExcludeAllDevicesExcluye el redireccionamiento de todos los dispositivos USB. Si está configurado como true, puede usar otras opciones de directivas para permitir el redireccionamiento de dispositivos o familias de dispositivos específicas. Si está configurado como false, puede usar otras opciones de directivas para evitar el redireccionamiento de dispositivos o familias de dispositivos específicas. Si establece Excluir todos los dispositivos en true en Horizon Agent y se envía esta configuración a Horizon Client, la configuración del agente sustituirá a la de Horizon Client. El valor predeterminado no está definido, lo que equivale a false.
Excluir familia de dispositivos Propiedad: viewusb.ExcludeFamilyExcluye el redireccionamiento de familias de dispositivos. El formato de la configuración es family_name_1[;family_name_2]... Por ejemplo: bluetooth;smart-card Si habilitó la división automática de dispositivo, Horizon Client examinará la familia de dispositivos de cada interfaz de un dispositivo USB compuesto para decidir cuál debe excluir. Si desactivó la división automática de dispositivos, Horizon Client examinará la familia de dispositivos de todo el USB compuesto. El valor predeterminado no está definido.
Excluir un dispositivo Vid/Pid Propiedad: viewusb.ExcludeVidPidEvita que se redireccionen dispositivos con identificadores de producto y de proveedor específicos. El formato de la configuración es vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Debe especificar los números de ID en hexadecimal. Puede utilizar el carácter comodín (*) en lugar de dígitos individuales en un ID. Por ejemplo: vid-0781_pid-****;vid-0561_pid-554c El valor predeterminado no está definido.
Excluir ruta Propiedad: viewusb.ExcludePath Excluye el redireccionamiento de dispositivos en rutas de puerto o concentrador especificado. El formato de la configuración es bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]... Debe especificar los números de puerto y bus en hexadecimal. No puede usar el carácter comodín en la ruta. Por ejemplo: bus-1/2/3_port-02;bus-1/1/1/4_port-ff El valor predeterminado no está definido.
Incluir familia de dispositivos Propiedad: viewusb.IncludeFamily Incluye familias de dispositivos que se pueden redireccionar. El formato de la configuración es family_name_1[;family_name_2]... Por ejemplo: storage El valor predeterminado no está definido.
Incluir ruta Propiedad: viewusb.IncludePath Incluye dispositivos en rutas de puerto o concentrador que pueden redireccionarse. El formato de la configuración es bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]... Debe especificar los números de puerto y bus en hexadecimal. No puede usar el carácter comodín en la ruta. Por ejemplo: bus-1/2_port-02;bus-1/7/1/4_port-0f El valor predeterminado no está definido.
Incluir un dispositivo Vid/Pid Propiedad: viewusb.IncludeVidPid Incluye dispositivos con identificadores de producto y proveedor específicos que se pueden redireccionar. El formato de la configuración es vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Debe especificar los números de ID en hexadecimal. Puede utilizar el carácter comodín (*) en lugar de dígitos individuales en un ID. Por ejemplo: vid-0561_pid-554c El valor predeterminado no está definido.
Evitar el reenvío automático de familias de dispositivos Propiedad: viewusb.ExAutoRedirectFamily Evita que familias de dispositivos se reenvíen automáticamente. El formato de la configuración es family_name_1[;family_name_2]... Por ejemplo: storage El valor predeterminado no está definido.
Evitar el reenvío automático de dispositivos con Vid/Pid Propiedad: viewusb.ExAutoRedirectVidPid Evita que dispositivos con identificadores de producto y de proveedor específicos se reenvíen automáticamente. El formato de la configuración es vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]... Debe especificar los números de ID en hexadecimal. Puede utilizar el carácter comodín (*) en lugar de dígitos individuales en un ID. Por ejemplo: vid-0561_pid-554c El valor predeterminado no está definido.

Ejemplos de redireccionamiento USB

Cada ejemplo incluye una descripción del efecto en el redireccionamiento USB.

  • Incluir la mayoría de dispositivos dentro de la familia de dispositivos mouse.

    viewusb.IncludeFamily = "mouse" 
    viewusb.ExcludeVidPid = "Vid-0461_Pid-0010;Vid-0461_Pid-4d20"
    

    La primera propiedad en este ejemplo comunica a Horizon Client que permita que se realice un redireccionamiento de los dispositivos de mouse a un escritorio remoto. La segunda propiedad reemplaza a la primera y comunica a Horizon Client que mantenga dos dispositivos de mouse específicos locales y que no los redireccione.

  • Activar la división automática de dispositivos, pero excluir un dispositivo determinado. En otro dispositivo determinado, mantener uno de sus componentes locales y redireccionar los otros componentes al escritorio remoto:

    viewusb.AllowAutoDeviceSplitting = "True"
    viewusb.SplitExcludeVidPid = "Vid-03f0_Pid-2a12"
    viewusb.SplitVidPid = "Vid-0911_Pid-149a(exintf:03)"
    viewusb.IncludeVidPid = "Vid-0911_Pid-149a"
    

    Los dispositivos USB compuestos consisten en una combinación de dos o varios dispositivos, como un dispositivo de entrada de vídeo y un dispositivo de almacenamiento. La primera propiedad de este ejemplo activa la división automática de los dispositivos compuestos. La segunda propiedad excluye la división del dispositivo USB compuesto especificado (Vid-03f0_Pid-2a12).

    La tercera línea le comunica a Horizon Client que trate los componentes de otro dispositivo compuesto (Vid-0911_Pid-149a) como dispositivos independientes, pero excluye el redireccionamiento del componente cuyo número de interfaz es 03. Este componente se mantiene de forma local.

    Debido a que este dispositivo compuesto incluye un componente que se suele excluir de forma predeterminada, como un mouse o un teclado, la cuarta línea es necesaria para que los otros componentes del dispositivo compuesto Vid-0911_Pid-149a se puedan redireccionar al escritorio remoto.

    Las tres primeras propiedades son propiedades de división. La última propiedad es una propiedad de filtrado. Las propiedades de filtrado se procesan antes que las propiedades de división.

Importante: Las propiedades de la configuración del cliente deben combinarse con las directivas correspondientes establecidas para Horizon Agent en el escritorio remoto (o reemplazarlas). Para obtener más información sobre cómo funcionan las propiedades de división y filtrado USB en el cliente junto con las directivas USB de Horizon Agent, consulte los temas relacionados con el uso de las directivas para controlar el redireccionamiento USB en el documento Funciones de escritorios remotos y GPO de Horizon.

¿Le resultó útil esta página?

Enviar comentarios sobre este tema

¿Le resultó útil este tema?

No incluya información personal ni confidencial.

Generando el enlace…