$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $

VBoxManage createmedium

VBoxManage-createmedium 1
VBoxManage-createmedium создает новый носитель &product-name;
`VBoxManage createmedium` disk dvd floppy --filename=имя-файла --size=мегабайты --sizebyte=байты --diffparent= UUID имя-файла --format= VDI VMDK VHD --variant Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk --property имя=значение --property-file имя=/путь/к/файлу/со/значением

## Описание

Команда `VBoxManage createmedium` создает новый носитель, такой как файл образа диска.

Для совместимости с ранними версиями &product-name; можно использовать команды `createvdi` и `createhd` вместо команды `createmedium`.

disk | dvd | floppy

  Указывает тип носителя. Значение по умолчанию `disk`.

`--filename=имя-файла`

  Указывает абсолютный путь к файлу в файловой системе хоста.

`--size=мегабайты`

  Задает емкость образа в мегабайтах.

`--sizebyte=байты`

  Задает емкость образа в байтах.

`--diffparent=UUID | имя-файла`

  Указывает Универсальный Уникальный Идентификатор (UUID) или абсолютный путь к родительскому файлу разностного образа в файловой системе хоста.

  Используйте этот файл для совместного использования базового образа диска между ВМ.

`--format=VDI | VMDK | VHD`

  Задает формат выходного файла. Допустимые форматы `VDI`, `VMDK` и `VHD`. Формат по умолчанию `VDI`.

`--variant=Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk`

  Задает варианты формата файла для целевого носителя в виде списка значений разделенных запятыми. Допустимы следующие значения:

  - `Standard` - это тип образа диска по умолчанию. Динамически расширяющийся файл.

  - `Fixed` использует файл образа диска фиксированного размера.

  - `Split2G` показывает, что образ диска разделяется на сегменты по 2 ГБ. Это значение только для VMDK.

  - `Stream` оптимизирует образ диска для загрузки. Это значение только для VMDK.

  - `ESX` используется в некоторых продуктах VMWare. Это значение только для VMDK.

  - `Formatted`

    Только для образов флоппи. Автоматически форматирует носитель.

  - `RawDisk` используется для создания raw дисков. Это значение только для VMDK.

  Заметим, что не все комбинации вариантов допустимы. Указание несовместимых значений вариантов в списке ведет к выдаче сообщения об ошибке.

`--property имя=значение`

  Задает требуемые параметры, зависящие от формата файла в форме `ключ=значение`. Опционально.

`--property-file name =/path/to/file/with/value`

  Задает требуемые параметры, зависящие от формата файла в форме `key=файл/со/значением`. Значение берется из файла. Опционально.

## Примеры

Следующая команда создает новый файл образа диска, называемый `disk01.vdi`. Файл имеет размер 1024 мегабайта.

    $ VBoxManage createmedium --filename disk01.vdi --size 1024

Следующая команда создает новый файл образа флоппи диска, называемый `floppy01.vdi`. Файл имеет размер 1 мегабайт.

    $ VBoxManage createmedium floppy --filename floppy01.img --size 1