Vous pouvez définir des propriétés de configuration USB dans les fichiers de configuration /etc/vmware/config, /usr/lib/vmware/config et ~/.vmware/config.
Utilisez la syntaxe suivante pour définir des 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 vous permettre d'inclure ou d'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é 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. Vous pouvez également consulter le fichier /tmp/vmware-<current_user>/vmware-view-usbd-*.log après avoir connecté le périphérique USB au système local lorsqu'Horizon Client est en cours d'exécution. Pour définir l'emplacement de ce fichier, utilisez la propriété view-usbd.log.fileName dans le fichier /etc/vmware/config, par exemple :
view-usbd.log.fileName = "/tmp/usbd.log"
Le tableau suivant décrit les propriétés de configuration USB disponibles.
| Nom et propriété de la stratégie | Description |
|---|---|
| Autoriser le fractionnement automatique de périphérique Propriété : viewusb.AllowAutoDeviceSplitting |
Autorise le fractionnement automatique de périphériques USB composites. La valeur par défaut est indéfinie, ce qui correspond à false. |
| Exclude Vid/Pid Device From Split Propriété : viewusb.SplitExcludeVidPid |
Exclut 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 individuels dans un ID. Par exemple : vid-0781_pid-55** La valeur par défaut n'est pas définie. |
| Split Vid/Pid Device Propriété : viewusb.SplitVidPid |
Traite 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 individuels dans un ID. Par exemple : vid-0781_pid-554c(exintf:01;exintf:02)
Note : Si le périphérique composite comprend des composants qui sont automatiquement exclus, tels qu'une souris ou un clavier, Horizon n'inclut alors pas automatiquement les composants que vous n'avez pas explicitement exclus. Vous devez spécifier une règle de filtre telle que
Include Vid/Pid Device pour inclure ces composants.
La valeur par défaut n'est pas définie. |
| Allow Audio Input Devices Propriété : viewusb.AllowAudioIn |
Permet 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 pas par défaut. |
| Allow Audio Output Devices Propriété : viewusb.AllowAudioOut |
Permet la redirection de périphériques de sortie audio. La valeur par défaut est indéfinie, ce qui correspond à false. |
| Autoriser HID Propriété : viewusb.AllowHID |
Autoriser la redirection des périphériques d'entrée autres que les claviers et les souris. La valeur par défaut est indéfinie, ce qui correspond à true. |
| Allow HIDBootable Propriété : viewusb.AllowHIDBootable |
Permet la redirection de périphériques d'entrée autres que des claviers et des souris qui sont disponibles au démarrage (ou périphériques démarrables par HID). La valeur par défaut est indéfinie, ce qui correspond à true. |
| Autoriser la description de périphérique a sécurité intégrée Propriété : viewusb.AllowDevDescFailsafe |
Autorise 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 est indéfinie, ce qui correspond à false. |
| Autoriser les périphériques de clavier et souris Propriété : viewusb.AllowKeyboardMouse |
Permet la redirection de claviers avec périphériques de pointage intégrés (souris, Trackball ou pavé tactile). La valeur par défaut est indéfinie, ce qui correspond à false. |
| Allow Smart Cards Propriété : viewusb.AllowSmartcard |
Permet la redirection de périphériques à carte à puce. La valeur par défaut est indéfinie, ce qui correspond à false. |
| Allow Video Devices Propriété : viewusb.AllowVideo |
Permet 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 pas par défaut. |
| Disable Remote Configuration Download Propriété : viewusb.DisableRemoteConfig |
Désactive 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 est indéfinie, ce qui correspond à false. |
| Exclude All Devices Propriété : viewusb.ExcludeAllDevices |
Exclut 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 règle 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 règle pour empêcher la redirection de périphériques spécifiques ou de familles de périphériques. Si vous définissez la valeur de Exclude All Devices sur true sur Horizon Agent, et si ce paramètre est transmis à Horizon Client, le paramètre d'Horizon Agent remplace celui d'Horizon Client. La valeur par défaut est indéfinie, ce qui correspond à false. |
| Exclude Device Family Propriété : viewusb.ExcludeFamily |
Exclut 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 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 examine la famille de périphérique de l'ensemble du périphérique USB composite. La valeur par défaut n'est pas définie. |
| Exclude Vid/Pid Device Propriété : viewusb.ExcludeVidPid |
Exclut des périphériques avec des ID de fournisseur et de produit spécifiés de la redirection. 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 individuels dans un ID. Par exemple : vid-0781_pid-****;vid-0561_pid-554c La valeur par défaut n'est pas définie. |
| Exclude Path 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. |
| Include Device Family 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. |
| Include Path 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. |
| Include Vid/Pid Device Propriété : viewusb.IncludeVidPid |
Inclut des périphériques avec des ID de fournisseur et de produit spécifiés pouvant ê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 individuels dans un ID. Par exemple : vid-0561_pid-554c La valeur par défaut n'est pas définie. |
| Exclure le transfert automatique des familles de périphériques Propriété : viewusb.ExAutoRedirectFamily |
Exclure des familles de périphériques de la transmission automatique. 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. |
| Exclure le transfert automatique du périphérique Vid/Pid Propriété : viewusb.ExAutoRedirectVidPid |
Exclut de la transmission automatique les 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 individuels 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é dans cet exemple indique à Horizon Client d'autoriser la redirection des souris vers un poste de travail Horizon. 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.
-
Activer 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 de deux périphériques ou plus, 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 de traiter les différents composants d'un autre périphérique composite (Vid-0911_Pid-149a) comme étant différents périphériques et d'exclure de la redirection le composant de numéro d'interface 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 de façon que les autres composants du périphérique composite Vid-0911_Pid-149a puissent être redirigés vers le poste de travail Horizon.
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.
