From 16f504a9dca3fe3b70568f67b7d41241ae485288 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 18:49:04 +0200 Subject: Adding upstream version 7.0.6-dfsg. Signed-off-by: Daniel Baumann --- doc/manual/ru_RU/man_VBoxManage-usbfilter.xml | 322 ++++++++++++++++++++++++++ 1 file changed, 322 insertions(+) create mode 100644 doc/manual/ru_RU/man_VBoxManage-usbfilter.xml (limited to 'doc/manual/ru_RU/man_VBoxManage-usbfilter.xml') diff --git a/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml b/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml new file mode 100644 index 00000000..f163754d --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml @@ -0,0 +1,322 @@ + + + + +%all.entities; +]> + + + $Date: 2023-01-11 13:15:45 +0100 (Wed, 11 Jan 2023) $ + VBoxManage usbfilter + + + + VBoxManage-usbfilter + 1 + + + + VBoxManage-usbfilter + управление USB фильтрами + &product-name; + + + + + + VBoxManage usbfilter add + индекс,0-N + --target= + uuid + имя-ВМ + global + + --name=строка + --action=ignore | hold + --active=yes | no + --vendorid=XXXX + --productid=XXXX + --revision=IIFF + --manufacturer=строка + --product=строка + --port=hex + --remote=yes | no + --serialnumber=строка + --maskedinterfaces=XXXXXXXX + + + + VBoxManage usbfilter modify + индекс,0-N + --target= + uuid + имя-ВМ + global + + --name=строка + --action=ignore | hold + --active=yes | no + --vendorid=XXXX | "" + --productid=XXXX | "" + --revision=IIFF | "" + --manufacturer=строка | "" + --product=строка | "" + --port=hex + --remote=yes | no + --serialnumber=строка | "" + --maskedinterfaces=XXXXXXXX + + + + VBoxManage usbfilter remove + индекс,0-N + --target= + uuid + имя-ВМ + global + + + + + + Описание + + Команда VBoxManage usbfilter позволяет управлять + USB фильтрами для указанной виртуальной машиной (ВМ) или глобальными + USB фильтрами, влияющими на всю конфигурацию &product-name;. + + + Глобальные фильтры применяются перед фильтрами определенной ВМ. + Это означает, что можно использовать глобальный фильтр для + предотвращения захвата устройств какой-либо ВМ. + + + Глобальные фильтры применяются в определенном порядке. Применяется + только первый походящий данному устройству фильтр. Например, + первый глобальный фильтр делает доступным определенный + флеш-накопитель Kingston, тогда как второй фильтр игнорирует все + устройства Kingston. В результате применения этих фильтров, + определенный флеш-накопитель Kingston будет доступен любой машине, + имеющей соответствующий фильтр, но остальные устройства Kingston + доступны не будут. + + + Общие операнды и опции + + + index,0-N + + Задает единственное число, указывающее позицию фильтра + в списке. Ноль (0) представляет + первую позицию в списке. Если в данной позиции уже + существует фильтр, то этот фильтр, а также + следующие за ним передвигаются ниже по списку. + В противном случае, новый фильтр добавляется в + список. + + + + + + Указывает, разрешать ли доступ ВМ к устройствам, + подходящим к описанию фильтра (hold) + или запрещать (ignore). Эта опция + применяется только к глобальным фильтрам. + + + + + + Указывает, активен ли USB фильтр или временно отключен. + Допустимые значения yes, активирующая + фильтр и no, отключающая его. Значение + по умолчанию yes. + + + + + + Задает фильтр по ID производителя как строку. Значение + по умолчанию пустое (""). + + + + + + Указывает фильтр маскированного интерфейса, который + используется для скрытия одного или нескольких USB + интерфейсов от гостевой системы. Значение - это битовая + маска, где набор битов соответствует скрываемому USB + интерфейсу или снятие маски. Эта функция поддерживается + только только в хост-системах Linux. + + + + + + Задает имя фильтра. + + + + + + Задает фильтр по номеру USB порта (hub port number). Значение по + умолчанию - пустая строка (""). + + + + + + Задает фильтр по ID продукта как строку. Значение по + умолчанию пустое (""). + + + + + + Задает фильтр по ID продукта. Строковое представление + для точного соответствия имеет вид + XXXX, где + X - это шестнадцатеричная + цифра включающая лидирующие нули. Значение по умолчанию + пустое (""). + + + + + + Задает удаленный фильтр, показывающий подключено ли + физически устройство к удаленному клиенту VRDE или + или к локальной системе. Эта опцию применяется только + к фильтрам ВМ. Значение по умолчанию пустое + (""). + + Почему значение по умолчанию пустое когда допустимые + значения yes или no? + + + + + + Задает фильтр по ID ревизии. Строковое представление + для точного соответствия имеет вид IIFF. + I - это десятичная цифра + целой части ревизии. F - + это десятичная цифра ее дробной части включающая + лидирующие и замыкающие нули. Значение по умолчанию + пустое (""). + + Для того, чтобы указать диапазон ревизий ID, убедитесь + что используется шестнадцатеричная форма, то есть в виде + 16 битного упакованного двоично-десятичного значения. + Например, выражение int:0x0100-0x0199 + соответствует любой ревизии с 1.0 по 1.99 включительно. + + + + + + Задает фильтр серийного номера как строку. Значение по + умолчанию пустое(""). + + + + + + Указывает ВМ, к которой подключается фильтр. Можно + указать Универсальный Уникальный Идентификатор (UUID) + или имя ВМ. Для применения описания фильтра ко всем ВМ, + укажите global. + + + + + + Задает фильтр по ID поставщика, который представляется + строкой шестнадцатеричного номера, состоящего из + четырех цифр включая лидирующие нули. Значение по + умолчанию пустое (""). + + + + + + Добавить USB фильтр или глобальный фильтр + + + Используйте команду VBoxManage usbfilter add + для создания нового USB фильтра. + + + Дополнительно укажите параметры для фильтрации. Можно использовать + команду VBoxManage list usbhost для просмотра + параметров устройств, подключенных к вашей системе. + + + + Изменить USB фильтр или глобальный фильтр + + + Используйте команду VBoxManage usbfilter modify + для изменения USB фильтра. Можно использовать команду + VBoxManage list usbfilters для отображения + индексов глобальных фильтров и команду + VBoxManage showvminfo для отображения + индексов по определенной машине. + + + + Удалить USB фильтр или глобальный фильтр + + + Используйте команду VBoxManage usbfilter remove + для удаления USB фильтра. + + + + + + Примеры + + + Следующая команда отображает доступные USB устройства в хост-системе. + +$ VBoxManage list usbhost + + Следующая команда добавляет USB фильтр, называемый + filter01 к ВМ ol7. + Фильтр определяет флеш-накопитель Kingston DataTraveler и + помещается первым в списке USB фильтров ВМ. + +$ VBoxManage usbfilter add 0 --target ol7 --name filter01 --vendorid 0x0930 --productid 0x6545 + + Следующая команда удаляет USB фильтр, который второй в списке + ВМ ol7 VM. + +$ VBoxManage usbfilter remove 1 --target ol7 + + -- cgit v1.2.3