Эта команда создает новый XML файл описания виртуальной машины.

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

Однако, если используются параметры --basefolder <path> и --settingsfile <filename>, XML файл описания получит имя <filename>, а каталог машины <path> . В данном случае, имена файла и каталога не будут меняться при переименовании виртуальной машины.

По умолчанию, эта команда создает только XML файл без регистрации его в списке доступных ВМ. Для регистрации ВМ, используется параметр --register, или позднее отдельно используется команда VBoxManage registervm.