VBoxManage usbfilter |
Filtre USB |
|---|---|
| VirtualBox | |
Syntaxe
| VBoxManage usbfilter add index,0-N --target uuid|name|global --name string --action ignore|hold (global filters only) [--active yes|no] (yes) [--vendorid XXXX] (null) [--productid XXXX] (null) [--revision IIFF] (null) [--manufacturer string] (null) [--product string] (null) [--remote yes|no] (null, VM filters only) [--serialnumber string] (null) [--maskedinterfaces XXXXXXXX] |
| VBoxManage usbfilter modify index,0-N --target uuid|vmname global [--name string] [--action ignore|hold (global filters only)] [--active yes|no] [--vendorid XXXX] [--productid XXXX] [--revision IIFF] [--manufacturer string] [--product string] [--remote yes|no (null, VM filters only)] [--serialnumber string] [--maskedinterfaces XXXXXXXX] |
| VBoxManage usbfilter remove index,0-N --target uuid|vmname global |
Paramètres
| Nom | Description |
|---|---|
| --action ignore|hold | Ce paramètre permet d'indiquer si les périphériques correspondant à la description du filtre sont autorisés à accéder aux machines (maintenir) ou si l'accès est refusé (ignorer). S'applique uniquement aux filtres globaux. |
| --active yes|no | Ce paramètre permet d'indiquer si le filtre USB est actif ou temporairement désactivé. Pour usbfilter create, la valeur par défaut est active. |
| --vendorid XXXX|"" | Ce paramètre permet d'indiquer un filtre d'identificateur de fournisseur. La représentation sous format de chaîne de caractères pour une correspondance exacte a la forme XXXX, où X est le chiffre hexadécimal, y compris les zéros non significatifs. |
| --productid XXXX|"" | Ce paramètre permet d'indiquer un filtre d'identificateur de produit. La représentation sous format de chaîne de caractères pour une correspondance exacte a la forme XXXX, où X est le chiffre hexadécimal, y compris les zéros non significatifs. |
| --revision IIFF|"" | Ce paramètre permet d'indiquer un filtre d'identificateur de révision. La représentation sous format de chaîne de caractères pour une correspondance exacte a la forme IIFF, où I est le chiffre décimal de la partie entière de la révision et F est le chiffre décimal de sa partie fractionnaire, y compris les zéros de début et de fin. Notez que pour les filtres d'intervalle, il est préférable d'utiliser la forme hexadécimale, car la révision est entreposée sous la forme d'une valeur BCD compressée 16 bits. Par conséquent, l'expression int:0x0100-0x0199 correspondra à n'importe quelle révision de 1.0 à 1.99 inclusivement. |
| --manufacturer string|"" | Ce paramètre permet d'indiquer un filtre d'identificateur de fabricant, sous forme de chaîne de caractères. |
| --product string|"" | Ce paramètre permet d'indiquer un filtre d'identificateur de produit, sous forme de chaîne de caractères. |
| --remote yes|no"" | Ce paramètre permet d'indiquer un filtre à distance, indiquant si le périphérique est physiquement connecté à un client VRDE à distance ou à une machine hôte locale. S'applique uniquement aux filtres de la machine virtuelle. |
| --serialnumber string|"" | Ce paramètre permet d'indiquer un filtre de numéro de série, sous forme de chaîne de caractères. |
| --maskedinterfaces XXXXXXXX | Ce paramètre permet d'indiquer un filtre d'interface masqué, pour masquer une ou plusieurs interfaces USB de l'invité. La valeur est un masque de bits où les bits définis correspondent aux interfaces USB devant être masquées ou masquées. Cette fonctionnalité ne fonctionne que sur les hôtes Linux. |
Description
Cette commande permet de travailler avec les filtres USB d'une machine virtuel, des filtres global lesquelles affecte les ajustements de VirtualBox.
Remarques
- Les commandes VBoxManage usbfilter sont utilisées pour travailler avec des filtres USB dans des machines virtuelles ou des filtres globaux affectant l'ensemble de la configuration de VirtualBox. Les filtres globaux sont appliqués avant les filtres spécifiques à la machine et peuvent être utilisés pour empêcher la capture de périphériques par une machine virtuelle. Les filtres globaux sont toujours appliqués dans un ordre particulier et seul le premier filtre correspondant à un périphérique est appliqué. Par exemple, si le premier filtre global dit de maintenir, ou de rendre disponible, un périphérique de clef mémoire Kingston particulier et le second filtre dit d'ignorer tous les périphériques Kingston. Cette clef mémoire Kingston particulière sera disponible pour n'importe quelle machine avec le filtre approprié, mais aucun autre périphérique Kingston ne le sera.
- Lors de la création d'un filtre USB à l'aide de la commande VBoxManage usbfilter add, vous devez fournir trois ou quatre paramètres obligatoires. L'index spécifie la position dans la liste à laquelle le filtre doit être placé. S'il y a déjà un filtre à cette position, alors celui-ci et les suivants seront décalés d'un endroit en arrière. Sinon, le nouveau filtre sera ajouté à la fin de la liste. Le paramètre cible sélectionne la machine virtuelle à laquelle le filtre doit être attaché ou utilise global pour l'appliquer à toutes les machines virtuelles. Le paramètre name est le nom du nouveau filtre. Pour les filtres globaux, l'action indique s'il faut autoriser les machines virtuelles à accéder aux périphériques correspondant à la description du filtre (maintenir) ou ne pas leur donner accès (ignorer). De plus, vous devez spécifier les paramètres sur lesquels filtrer. Vous pouvez trouver les paramètres des périphériques connectés à votre système à l'aide de VBoxManage list usbhost. Enfin, vous pouvez spécifier si le filtre doit être actif. Pour les filtres locaux, qu'ils soient destinés aux périphériques locaux, aux périphériques à distances via une connexion RDP ou aux deux.
- Lorsque vous modifiez un filtre USB à l'aide de VBoxManage usbfilter modify, vous devez spécifier le filtre par index et par cible, qui est une machine virtuelle ou globale. Voir la sortie des usbfilters de la liste VBoxManage pour trouver les index de filtres globaux et VBoxManage showvminfo pour trouver les index des machines individuelles. Les propriétés pouvant être modifiées sont les mêmes que pour VBoxManage usbfilter add. Pour supprimer un filtre, utilisez VBoxManage usbfilter remove et spécifiez l'index et la cible.
Voir également
Articles - Virtualisation
Article - Les géants de l'informatique - Oracle
Dernière mise à jour : Samedi, le 3 octobre 2015