Эта команда создает новый XML файл описания виртуальной машины.
Параметр --name <name>
необходим и определяет наименование машины. Это имя по умолчанию присваивается файлу настроек (имеющем расширение .xml
) и каталогу ВМ (создается в каталоге .VirtualBox/Machines
), и поэтому оно должно соответствовать требованиям ОС хоста к наименованиям файлов. Если ВМ будет позже переименована, то файл и каталог будут также изменены автоматически.
Однако, если используются параметры --basefolder <path>
и --settingsfile <filename>
, XML файл описания получит имя <filename>
, а каталог машины <path>
. В данном случае, имена файла и каталога не будут меняться при переименовании виртуальной машины.
По умолчанию, эта команда создает только XML файл без регистрации его в списке доступных ВМ. Для регистрации ВМ, используется параметр --register
, или позднее отдельно используется команда VBoxManage registervm
.