# VBoxManage createvm

VBoxManage-createvm

1

VBoxManage-createvm

создает новую виртуальную машину

&product-name;

          VBoxManage createvm
          --name=имя-ВМ
          --basefolder=основная-папка
          --default
          --groups=ID-группы,...
          --ostype=тип-ОС
          --register
          --uuid=uuid

## Описание

Команда `VBoxManage createvm` создает новый XML-файл определения виртуальной машины (ВМ).

Необходимо указать имя ВМ, используя `--name `имя-ВМ``. Это имя по умолчанию используется как имя файла настроек, имеющего расширение `.vbox`, а также как имя папки машины, находящейся в директории `$HOME/VirtualBox VMs`.

Фактическое имя файла может не соответствовать имени ВМ если оно нарушает требования к имени файла ОС хоста (например использование разделителя пути или других зарезервированных символов, все это будет заменено на символ подстановки). Если ВМ будет позднее переименована, имена файла и папки будут обновлены автоматически чтобы соответствовать новому имени.

## Опции команды

В дополнение к требуемому указанию имени или UUID ВМ, можно указать следующие опции:

`--basefolder=`основная-папка``

- Задает имя папки в которую сохранять файл конфигурации машины для новой ВМ.

  Обратите внимание, что имена файла и папки не изменяются если переименовать ВМ.

`--default`

- Применяет аппаратную конфигурацию по умолчанию для указанной гостевой ОС. По умолчанию, ВМ создается с минимальным оборудованием.

`--groups=`ID-группы`,...`

- Назначает ВМ на указанные группы. Если указывается более чем одна группа, разделите их запятыми.

  Заметим, что каждая группа идентифицируется через ID группы, начинающаяся с символа слэш (`/`), поэтому группы могут быть вложенные. По умолчанию, ВМ всегда назначается на группу `/`.

`--ostype=`тип-ОС``

- Указывает гостевую ОС для запуска в ВМ. Запустите команду `VBoxManage list ostypes` для просмотра доступных типов ОС.

`--register`

- Регистрирует ВМ в &product-name;. По умолчанию команда `VBoxManage createvm` создает только XML конфигурацию для ВМ но не регистрирует ВМ. Если не регистрировать ВМ при создании, можно запустить команду `VBoxManage registervm` после создания.

`--uuid=`uuid``

- Задает Универсальный Уникальный Идентификатор (UUID) ВМ. Убедитесь что этот UUID уникален в пространстве имен &product-name; хоста или его членства в группах ВМ, если хотите зарегистрировать ВМ. По умолчанию &product-name; предоставляет UUID.

## Примеры

Следующая команда создает ВМ называемую `vm2` где планируется запускать 64 битную версию Orace Linux.

    $ VBoxManage createvm --name "vm2" --ostype "Oracle_64"

Следующая команда создает и регистрирует ВМ называемую `vm3`.

    $ VBoxManage createvm --name "vm3" --register

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

vboxmanage-list, vboxmanage-registervm