Skip to main content

6 janvier 2026

Définition de propriétés de configuration USB

Vous pouvez définir des propriétés de configuration USB dans les fichiers de configuration.

Utilisez la syntaxe suivante pour définir les propriétés de configuration USB dans les fichiers de configuration.

viewusb.property1 = "value1"

Avec les propriétés de configuration USB, vous pouvez contrôler si certains types de périphériques sont redirigés. Des propriétés de filtrage sont également disponibles pour que vous puissiez inclure ou exclure certains types de périphériques. Des propriétés pour le fractionnement de périphériques composites sont également fournies.

Certaines valeurs de propriétés nécessitent le VID (ID du fournisseur) et le PID (ID du produit) pour un périphérique USB. Pour connaître le VID et le PID, vous pouvez rechercher le nom du produit sur Internet, associé à vid et pid.

Le tableau suivant décrit les propriétés de configuration USB disponibles.

Propriétés de configuration pour la redirection USB
Nom et propriété de la stratégieDescription
Autoriser le fractionnement automatique de périphérique Propriété : viewusb.AllowAutoDeviceSplittingAutorise le fractionnement automatique de périphériques USB composites. La valeur par défaut n'est pas définie, ce qui correspond à false.
Exclure un périphérique Vid/Pid du fractionnement Propriété : viewusb.SplitExcludeVidPidExclut un périphérique USB composite spécifié par des ID de fournisseur et de produit du fractionnement. Le format du paramètre est vid-xxx1_pid-yyy1[;vid-xxx2_pid-yyy2]... Vous devez spécifier des numéros d'ID au format hexadécimal. Vous pouvez utiliser le caractère générique (*) à la place de chiffres dans un ID. Par exemple : vid-0781_pid-55** La valeur par défaut n'est pas définie.
Fractionner un périphérique Vid/Pid Propriété : viewusb.SplitVidPidTraite les composants d'un périphérique USB composite spécifiés par des ID de fournisseur et de produit en tant que périphériques séparés. Le format du paramètre est vid-xxxx_pid-yyyy([exintf:zz[;exintf:ww ]])[;...] Vous pouvez utiliser le mot-clé exintf pour exclure des composants de la redirection en spécifiant leur numéro d'interface. Vous devez spécifier les numéros d'ID au format hexadécimal et les numéros d'interface au format décimal en incluant les zéros à gauche. Vous pouvez utiliser le caractère générique (*) à la place de chiffres dans un ID. Par exemple : vid-0781_pid-554c(exintf:01;exintf:02) Remarque : si le périphérique composite comprend des composants qui sont automatiquement exclus, tels qu'une souris ou un clavier, Horizon Client n'inclut alors pas automatiquement les composants que vous n'avez pas explicitement exclus. Vous devez spécifier une stratégie de filtre comme Inclure un périphérique Vid/Pid pour inclure ces composants. La valeur par défaut n'est pas définie.
Autoriser les périphériques d'entrée audio Propriété : viewusb.AllowAudioInPermet la redirection de périphériques d'entrée audio. La valeur par défaut n'est pas définie, ce qui correspond à false, car la fonctionnalité Audio/Vidéo en temps réel est utilisée pour les périphériques d'entrée audio et vidéo, mais la redirection USB ne l'est par défaut.
Autoriser les périphériques de sortie audio Propriété : viewusb.AllowAudioOutPermet la redirection de périphériques de sortie audio. La valeur par défaut n'est pas définie, ce qui correspond à false.
Autoriser HID Propriété : viewusb.AllowHIDAutorise la redirection des périphériques d'entrée autres que les claviers et les souris. La valeur par défaut n'est pas définie, ce qui correspond à true.
Autoriser les périphériques HID amorçables Propriété : viewusb.AllowHIDBootablePermet la redirection de périphériques d'entrée autres que des claviers et des souris qui sont disponibles au démarrage (ou terminaux démarrables par HID). La valeur par défaut n'est pas définie, ce qui correspond à true.
Autoriser la sécurité intégrée du descripteur de périphérique Propriété : viewusb.AllowDevDescFailsafeAutorise la redirection des périphériques même si Horizon Client ne parvient pas à obtenir les descripteurs de configuration/périphérique. Pour autoriser un périphérique même si config/desc échoue, incluez-le dans les filtres d'inclusion tels que IncludeVidPid ou IncludePath. La valeur par défaut n'est pas définie, ce qui correspond à false.
Autoriser les claviers et souris Propriété : viewusb.AllowKeyboardMousePermet la redirection de claviers avec périphériques de pointage intégrés (souris, Trackball ou pavé tactile). La valeur par défaut n'est pas définie, ce qui correspond à false.
Autoriser les périphériques de carte à puce Propriété : viewusb.AllowSmartcardPermet la redirection de périphériques à carte à puce. La valeur par défaut n'est pas définie, ce qui correspond à false.
Autoriser les périphériques vidéo Propriété : viewusb.AllowVideoPermet la redirection de périphériques vidéo. La valeur par défaut n'est pas définie, ce qui correspond à false, car la fonctionnalité Audio/Vidéo en temps réel est utilisée pour les périphériques d'entrée audio et vidéo, mais la redirection USB ne l'est par défaut.
Désactiver le téléchargement de configuration à distance Propriété : viewusb.DisableRemoteConfigInterdit l'utilisation des paramètres d'Horizon Agent lors de l'exécution du filtrage des périphériques USB. La valeur par défaut n'est pas définie, ce qui correspond à false.
Exclure tous les périphériques Propriété : viewusb.ExcludeAllDevicesExclut tous les périphériques USB de la redirection. Si ce paramètre est défini sur true, vous pouvez utiliser d'autres paramètres de stratégie pour autoriser la redirection de périphériques spécifiques ou de familles de périphériques. Si ce paramètre est défini sur false, vous pouvez utiliser d'autres paramètres de stratégie pour empêcher la redirection de périphériques spécifiques ou de familles de périphériques. Si vous définissez la valeur d'Exclure tous les périphériques sur true sur Horizon Agent et que ce paramètre est transmis à Horizon Client, le paramètre Horizon Agent remplace le paramètre d'Horizon Client. La valeur par défaut n'est pas définie, ce qui correspond à false.
Exclure une famille de périphériques Propriété : viewusb.ExcludeFamilyExclut des familles de périphériques de la redirection. Le format du paramètre est nom_famille_1[;nom_famille_2]… Par exemple : bluetooth;smart-card Si vous avez activé le fractionnement automatique de périphérique, Horizon Client examine la famille de périphériques de chaque interface d'un périphérique USB composite pour décider quelles interfaces doivent être exclues. Si vous avez désactivé le fractionnement automatique de périphérique, Horizon Client examine la famille de périphériques de l'ensemble du périphérique USB composite. La valeur par défaut n'est pas définie.
Exclure un périphérique Vid/Pid Propriété : viewusb.ExcludeVidPidExclut de la redirection des périphériques ayant des ID de fournisseur et de produit spécifiques. Le format du paramètre est vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]… Vous devez spécifier des numéros d'ID au format hexadécimal. Vous pouvez utiliser le caractère générique (*) à la place de chiffres dans un ID. Par exemple : vid-0781_pid-****;vid-0561_pid-554c La valeur par défaut n'est pas définie.
Exclure le chemin d'accès Propriété : viewusb.ExcludePath Exclut des périphériques dans des chemins de concentrateur ou de port spécifiés de la redirection. Le format du paramètre est bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]… Vous devez spécifier des numéros de bus et de port au format hexadécimal. Vous ne pouvez pas utiliser le caractère générique dans les chemins. Par exemple : bus-1/2/3_port-02;bus-1/1/1/4_port-ff La valeur par défaut n'est pas définie.
Inclure une famille de périphériques Propriété : viewusb.IncludeFamily Inclut des familles de périphériques pouvant être redirigées. Le format du paramètre est nom_famille_1[;nom_famille_2]… Par exemple : storage La valeur par défaut n'est pas définie.
Inclure le chemin d'accès Propriété : viewusb.IncludePath Inclut des périphériques dans des chemins de concentrateur ou de port spécifiés pouvant être redirigés. Le format du paramètre est bus-x1[/y1]..._port-z1[;bus-x2[/y2]..._port-z2]… Vous devez spécifier des numéros de bus et de port au format hexadécimal. Vous ne pouvez pas utiliser le caractère générique dans les chemins. Par exemple : bus-1/2_port-02;bus-1/7/1/4_port-0f La valeur par défaut n'est pas définie.
Inclure un périphérique Vid/Pid Propriété : viewusb.IncludeVidPid Inclut les périphériques qui ont un ID de fournisseur et de produit spécifié qui peuvent être redirigés. Le format du paramètre est vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]… Vous devez spécifier des numéros d'ID au format hexadécimal. Vous pouvez utiliser le caractère générique (*) à la place de chiffres dans un ID. Par exemple : vid-0561_pid-554c La valeur par défaut n'est pas définie.
Empêcher le transfert automatique des familles de périphériques Propriété : viewusb.ExAutoRedirectFamily Empêche que les familles de périphériques soient transférées automatiquement. Le format du paramètre est nom_famille_1[;nom_famille_2]… Par exemple : storage La valeur par défaut n'est pas définie.
Empêcher le transfert automatique du périphérique Vid/Pid Propriété : viewusb.ExAutoRedirectVidPid Empêche le transfert automatique des périphériques portant des ID de fournisseur et de produit spécifiés. Le format du paramètre est vid-xxx1_pid-yyy2[;vid-xxx2_pid-yyy2]… Vous devez spécifier des numéros d'ID au format hexadécimal. Vous pouvez utiliser le caractère générique (*) à la place de chiffres dans un ID. Par exemple : vid-0561_pid-554c La valeur par défaut n'est pas définie.

Exemples de redirection USB

Chaque exemple est suivi d'une description de l'effet sur la redirection USB.

  • Inclure la plupart des périphériques dans la famille de souris.

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

    La première propriété de cet exemple indique à Horizon Client d'autoriser la redirection des souris vers un poste de travail distant. La deuxième propriété remplace la première et indique à Horizon Client de maintenir deux souris spécifiques en mode local et de ne pas les rediriger.

  • Activez le fractionnement automatique de périphérique, mais exclure un périphérique particulier du fractionnement. Pour un autre périphérique particulier, laisser un de ses composants local et rediriger les autres composants vers le poste de travail distant :

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

    Les périphériques USB composites sont composés d'au moins deux périphériques, tels qu'un périphérique d'entrée vidéo et un périphérique de stockage. La première propriété de cet exemple active le fractionnement automatique des périphériques composites. La deuxième propriété exclut le périphérique USB composite spécifié (Vid-03f0_Pid-2a12) du fractionnement.

    La troisième ligne indique à Horizon Client qu'il faut traiter les composants d'un périphérique composite différent (Vid-0911_Pid-149a) en tant que périphériques distincts, mais qu'il faut exclure le composant suivant d'être redirigé : celui dont le numéro d'interface est le 03. Ce composant est conservé en mode local.

    Du fait que ce périphérique composite inclut un composant qui est normalement exclu par défaut, tel qu'une souris ou un clavier, la quatrième ligne est nécessaire pour que les autres composants du périphérique composite Vid-0911_Pid-149a puissent être redirigés vers le poste de travail distant.

    Les trois premières propriétés sont des propriétés de fractionnement. La dernière propriété est une propriété de filtrage. Les propriétés de filtrage s'effectuent avant les propriétés de fractionnement.

Important : ces propriétés de configuration du client peuvent être fusionnées avec des stratégies correspondantes paramétrées pour Horizon Agent sur le poste de travail distant, ou remplacées par celles-ci. Pour plus d'informations sur le fonctionnement des propriétés de fractionnement et de filtrage USB avec les stratégies USB d'Horizon Agent, consultez les rubriques traitant de l'utilisation de stratégies pour contrôler la redirection USB dans le document des Fonctionnalités et GPO des postes de travail distants Horizon.

Cette page vous a-t-elle été utile ?

Envoyer un commentaire sur cette rubrique

Cette rubrique vous a-t-elle été utile ?

N'indiquez aucune information personnelle ou confidentielle.

Génération du lien…