# VBoxManage

VBoxManage

1

VBoxManage

&product-name; интерфейс командной строки

&product-name;

          VBoxManage

            -V
            --version

          --dump-build-type

            -q
            --nologo

          --settingspw=пароль
          --settingspwfile=файл с паролем
          @файл ответов
          help подкоманда

## Описание

Команда `VBoxManage` - это интерфейс командной строки (CLI) для ПО &product-name;. CLI поддерживает весь функционал, доступный из графического интерфейса &product-name; (GUI). В дополнении, можно использовать команду `VBoxManage` для управления функционалом ядра виртуализации, недоступного из GUI.

Каждый раз, когда вы вызываете команду `VBoxManage`, исполняется только одна команда. Однако заметим, что некоторые подкоманды `VBoxManage` вызывают несколько подкоманд.

Запустите команду `VBoxManage` из командной строки операционной системы (ОС) хоста для управления ПО &product-name;.

Команда `VBoxManage` находится в следующих местах в зависимости от операционной системы хоста:

- Linux: `/usr/bin/VBoxManage`

- Mac OS X: `/Applications/VirtualBox.app/Contents/MacOS/VBoxManage`

- Oracle Solaris: `/opt/VirtualBox/bin/VBoxManage`

- Windows: `C:\Program Files\Oracle\VirtualBox\VBoxManage.exe`

В дополнении к управлению виртуальными машинами (ВМ) через CLI или GUI, можно использовать `VBoxHeadless` CLI для управления ВМ напрямую.

Команда `VBoxManage` производит специфические задачи через подкоманды, такие как `list`, `createvm` и `startvm`. Смотри соответствующую информацию по каждой подкоманде `VBoxManage`.

Если нужно, ВМ может быть указана по ее имени или универсальному уникальному идентификатору (UUID).

Команда `VBoxManage list vms` может быть использована для получения информации обо всех зарегистрированных на данный момент ВМ, включая их имена и UUID.

Заметим, что имя ВМ должно быть заключено в кавычки если оно содержит пробелы.

### Общие настройки

`--nologo`

- Подавляет вывод логотипа. Опция полезна для скриптов.

  Краткая версия этой опции: `-q`.

`--settingspw=[`пароль`]`

- Указывает пароль для доступа к настройкам. Опционально, можно указать сам пароль в качестве аргумента к опции. Если этого не будет сделано, команда `VBoxManage` спросит пароль у вас.

  Пароль для доступа к настройкам - это функция безопасности, которая шифрует настройки. По умолчанию настройки сохраняются обычным текстом в открытом виде.

  Вы не можете расшифровать зашифрованные настройки. Так что, если настройки зашифрованы, вы должны продолжать указывать `--settingspw` или `--settingspwfile`.

  В настоящее время шифруется только пароль iSCSI.

`--settingspwfile=`файл с паролем``

- Указывает файл, содержащий пароль к настройкам.

`--version`

- Показывает информацию о версии команды `VBoxManage`.

  Краткая версия это опции: `-V`.

@`файл ответов`

- Загружает аргументы из файла ответов в формате Bourne shell.

`подкоманда`

- Указывает одну из подкоманд `VBoxManage`, такие как `controlvm`, `createvm`, `list`, `modifyvm`, `showvminfo`, `startvm`, `storageattach` и `storagectl`.

  Каждая подкоманда описывается в своем топике, некоторые из них показаны в секции 'Смотрите также'.

## Примеры

Следующая команда создает виртуальную машину с именем `Win8` и регистрирует ее в &product-name;, используя опцию `--register`.

    $ VBoxManage createvm --name "Win8" --register
    Виртуальная машина 'Win8' создана и зарегистрирована.
    UUID: строка UUID
    Файл настроек: '/home/имя пользователя/VirtualBox VMs/Win8/Win8.vbox'

Вывод команды показывает, что ВМ `Win8` назначен UUID и XML файл настроек машины.

Вы можете использовать команду `VBoxManage showvminfo` для просмотра информации о конфигурации ВМ.

Следующий пример использует команду `VBoxManage modifyvm` для изменения размера памяти у ВМ `Windows XP` VM до 1024 мегабайта:

    $ VBoxManage modifyvm "Windows XP" --memory 1024

Заметим, что вы можете использовать команду `VBoxManage modifyvm` даже если ВМ выключена.

Вы можете использовать команду `VBoxManage storagectl` или команду `VBoxManage storageattach` для изменения конфигурации носителей у ВМ. Например, чтобы создать SATA контроллер с именем `sata01` и добавить его в ВМ `ol7` VM используйте:

    $ VBoxManage storagectl ol7 --name "sata01" --add sata

Используйте команду `VBoxManage startvm` для старта ВМ, которая сейчас выключена. Например, чтобы запустить ВМ `win7` укажите:

    $ VBoxManage startvm win7

Используйте команду `VBoxManage controlvm` для приостановки или сохранения состояния ВМ, которая сейчас работает. Вы также можете использовать эту команду для изменения настроек ВМ. Например, чтобы включить аудио вход для ВМ `ol6u9` используйте:

    $ VBoxManage controlvm ol6u9 audioin on

## Смотрите также

vboxmanage-controlvm, vboxmanage-createvm, vboxmanage-list, vboxmanage-modifyvm, vboxmanage-showvminfo, vboxmanage-startvm, vboxmanage-storageattach, vboxmanage-storagectl