# VBoxManage dhcpserver

VBoxManage-dhcpserver

1

VBoxManage-dhcpserver

Управление DHCP сервером

&product-name;

          VBoxManage dhcpserver add

            --network=имя-сети
            --interface=имя-интерфейса

          --server-ip=адрес
          --netmask=маска
          --lower-ip=адрес
          --upper-ip=адрес

            --enable
            --disable

            --global
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды

            --group=имя
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --incl-mac=адрес
            --excl-mac=адрес
            --incl-mac-wild=шаблон
            --excl-mac-wild=шаблон
            --incl-vendor=строка
            --excl-vendor=строка
            --incl-vendor-wild=шаблон
            --excl-vendor-wild=шаблон
            --incl-user=строка
            --excl-user=строка
            --incl-user-wild=шаблон
            --excl-user-wild=шаблон
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды

            --vm=имя|uuid
            --nic=1-N
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --fixed-address=адрес

            --mac-address=адрес
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --fixed-address=адрес

          VBoxManage dhcpserver modify

            --network=имя-сети
            --interface=имя-интерфейса

          --server-ip=адрес
          --lower-ip=адрес
          --upper-ip=адрес
          --netmask=маска

            --enable
            --disable

            --global
            --del-opt=номер-опции-dhcp
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp значение
            --force-opt=номер-опции-dhcp
            --unforce-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --unsuppress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --remove-config

            --group=имя
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --unforce-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --unsuppress-opt=номер-опции-dhcp
            --del-mac=адрес
            --incl-mac=адрес
            --excl-mac=адрес
            --del-mac-wild=шаблон
            --incl-mac-wild=шаблон
            --excl-mac-wild=шаблон
            --del-vendor=строка
            --incl-vendor=строка
            --excl-vendor=строка
            --del-vendor-wild=шаблон
            --incl-vendor-wild=шаблон
            --excl-vendor-wild=шаблон
            --del-user=строка
            --incl-user=строка
            --excl-user=строка
            --del-user-wild=шаблон
            --incl-user-wild=шаблон
            --excl-user-wild=шаблон
            --zap-conditions
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --remove-config

            --vm=имя|uuid
            --nic=1-N
            --del-opt=номер-опции-dhcp
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --unforce-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --unsupress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --fixed-address=адрес
            --remove-config

            --mac-address=адрес
            --del-opt=номер-опции-dhcp
            --set-opt=номер-опции-dhcp значение
            --set-opt-hex=номер-опции-dhcp строка-hex
            --force-opt=номер-опции-dhcp
            --unforce-opt=номер-опции-dhcp
            --suppress-opt=номер-опции-dhcp
            --unsuppress-opt=номер-опции-dhcp
            --min-lease-time=секунды
            --default-lease-time=секунды
            --max-lease-time=секунды
            --fixed-address=адрес
            --remove-config

          VBoxManage dhcpserver remove

            --network=имя-сети
            --interface=имя-интерфейса

          VBoxManage dhcpserver start

            --network=имя-сети
            --interface=имя-интерфейса

          VBoxManage dhcpserver restart

            --network=имя-сети
            --interface=имя-интерфейса

          VBoxManage dhcpserver stop

            --network=имя-сети
            --interface=имя-интерфейса

          VBoxManage dhcpserver findlease

            --network=имя-сети
            --interface=имя-интерфейса

          --mac-address=mac

## Описание

Команды `dhcpserver` позволяют управлять встроенным в VirtualBox DHCP сервером. Это может быть полезно при использовании внутренней сети или сети хоста. Теоретически, его можно использовать также и для сетевого моста, но это может вызвать конфликты с другими DHCP серверами, находящимся в вашей физической сети.

### Общие параметры

Все подкоманды `dhcpserver` работают во внутренней сети, идентифицируемой через ее имя или, в случае с сетью хоста, через имя интерфейса:

--network=`имя-сети`

- Имя внутренней сети. Это то же самое имя, которое было задано в опции `VBoxManage modifyvm --intnet` при настройке ВМ на внутреннюю сеть. Также его можно посмотреть в поле "Имя сети VBox" вывода команд `VBoxManage list intnets`, `VBoxManage list natnets` или `VBoxManage list hostonlyifs`.

--interface=`имя-интерфейса`

- Имя интерфейса сети хоста. Это то же самое имя, которое было задано в опции `VBoxManage modifyvm --host-only-adapter` при настройке ВМ на сеть хоста. Оно также может быть получено в поле "Имя" вывода команды `VBoxManage list hostonlyifs`.

### dhcpserver add

Добавляет новый DHCP сервер в сеть или интерфейс сети хоста.

Опции для настройки ядра DHCP сервера:

`--server-ip=`адрес``

- IP адрес, который должен быть у DHCP сервера.

`--lower-ip=`адрес``, `--upper-ip=`адрес``

- Диапазон IP адресов в управлении у DHCP сервера. Он не должен включать адрес самого DHCP сервера, но должен быть в той же сети. Границы включены, так что и верхний и нижний адреса также распределяются между клиентами.

`--netmask=`маска``

- Сетевая маска. Обычно 255.255.255.0.

`--enable`, --disable

- Включает или выключает DHCP сервер. Если не указан, сервер создается в выключенном состоянии и не распределяет адресов.

Опции, определяющие область настроек:

`--global`

- Задать глобальную область настроек. Любые последующие опции `--set-opt` будут применены ко всем клиентам DHCP.

`--vm=`имя-ВМ|uuid``

- Задать область настроек, ограниченную первым NIC указанной ВМ. Любые последующие опции `--set-opt` будут применены только к этому интерфейсу и никуда больше.

`--nic=`1-N``

- Задать область настроек, ограниченную указанным номером интерфейса ВМ, заданной через опцию `--vm`.

`--mac-address=`адрес``

- Задать область настроек, ограниченную указанным MAC адресом.

`--group=`имя``

- Задать область настроек, ограниченную указанной группой.

Опции для настройки текущей выбранной области:

`--set-opt=`номер-опции-dhcp значение``

- Добавляет указанный номер опции DHCP (0-255) и значение. Формат значения опции зависит от опции (обычно человеко-читаемый) и проверяется API и сервером DHCP.

`--set-opt-hex=`номер-опции-dhcp строка-hex``

- Добавляет указанный номер опции DHCP (0-255) и значение. Значение параметра задается в виде необработанной последовательности шестнадцатеричных байтов, которые могут быть разделены двоеточием. Проверка этих значений не производится ни API, ни DHCP сервером, они как есть передаются клиенту.

`--force-opt=`номер-опции-dhcp``

- Принудительно отправляет указанный номер опции DHCP (0-255) клиенту независимо от того, запрашивал он это или нет (при условии, что опция настроена со значением на некотором уровне).

`--suppress-opt=`номер-опции-dhcp``

- Предотвращает отправку клиенту указанного номера опции DHCP (0–255), если он присутствует в этой или более высокой области настроек.

`--min-lease-time=`секунды``

- Устанавливает минимальное время аренды для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--default-lease-time=`секунды``

- Задает время аренды по умолчанию для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--max-lease-time=`секунды``

- Устанавливает максимальное время аренды для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--fixed-address=`адрес``

- Назначение фиксированного адреса для области настроек `--vm` или `--mac-address`. Пустой `адрес` возвращает обратно назначение динамического адреса.

Опции для настройки условий членства в группе (исключение, переопределение, включение):

`--incl-mac=`адрес``

- Включает указанный MAC адрес в группу.

`--excl-mac=`адрес``

- Исключает указанный MAC адрес из группы.

`--incl-mac-wild=`шаблон``

- Включает указанный шаблон MAC адреса в группу.

`--excl-mac-wild=`шаблон``

- Исключает указанный шаблон MAC адреса из группы.

`--incl-vendor=`строка``

- Включает указанный ID класса поставщика в группу.

`--excl-vendor=`строка``

- Исключает указанный ID класса поставщика из группы.

`--incl-vendor-wild=`шаблон``

- Включает указанный шаблон ID класса поставщика в группу.

`--excl-vendor-wild=`шаблон``

- Исключает указанный шаблон ID класса поставщика из группы.

`--incl-user=`строка``

- Включает указанный ID класса пользователя в группу.

`--excl-user=`строка``

- Исключает указанный ID класса пользователя из группы.

`--incl-user-wild=`шаблон``

- Включает указанный шаблон ID класса пользователя в группу.

`--excl-user-wild=`шаблон``

- Исключает указанный шаблон ID класса пользователя из группы.

### dhcpserver modify

Команда модифицирует существующую конфигурацию сервера DHCP. Она принимает те же опции как и команда `add` и в дополнении нижеследующие, относящиеся к области настроек:

`--del-opt=`номер-опции-dhcp``

- Противоположность к `--set-opt`, которая удаляет указанный номер опции DHCP (0-255) из настроек сервера. Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--unforce-opt=`номер-опции-dhcp``

- Удаляет указанный номер опции DHCP (0-255) из списка принудительно передаваемых клиенту опций (то есть обратная к `--force-opt`). Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--unsuppress-opt=`номер-опции-dhcp``

- Удаляет указанный номер DHCP (0-255) из списка опций для подавления передачи клиенту (то есть обратная к `--suppress-opt`). Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--remove-config`

- Удаляет настройки из текущей области. Область `--global` нельзя удалить. После этой опции область настроек будет изменена на `--global`.

И дополнение к опциям условий членства в группах:

`--del-mac=`адрес``

- Удаляет указанный MAC адрес из условий группы.

`--del-mac-wild=`шаблон``

- Удаляет указанный шаблон MAC адреса из условий группы.

`--del-vendor=`строка``

- Удаляет указанный ID класса поставщика из условий группы.

`--del-vendor-wild=`шаблон``

- Удаляет указанный шаблон ID класса поставщика из условий группы.

`--del-user=`строка``

- Удаляет указанный ID класса пользователя из условий группы.

`--del-user-wild=`pattern``

- Удаляет указанный шаблон ID класса пользователя из условий группы.

`--zap-conditions`

- Удаляет все условия группы.

### dhcpserver remove

Удаляет указанный сервер DHCP.

### dhcpserver start

Запускает указанный сервер DHCP.

### dhcpserver restart

Перезапускает указанный сервер DHCP. Сервер DHCP должен работать на момент запуска команды.

### dhcpserver stop

Останавливает указанный сервер DHCP.

### dhcpserver findlease

Производит просмотр базы данных аренды. Эта команда в основном для получения IP адреса работающей ВМ.

`--mac-address=`mac``

- MAC адрес для просмотра в базе данных аренды.

### Общие параметры DHCP: