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

VBoxManage modifymedium

VBoxManage-modifymedium 1
VBoxManage-modifymedium изменяет характеристики существующего образа диска &product-name;
`VBoxManage modifymedium` disk dvd floppy uuid имя-файла --autoreset=on | off --compact --description=описание --move=путь --property=имя=[значение] --resize=мегабайты | --resizebyte=байты --setlocation=путь --type=normal | writethrough | immutable | shareable | readonly | multiattach

## Описание

Команда `VBoxManage modifymedium` позволяет изменить характеристики существующего образа диска.

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

disk | dvd | floppy

  Задает тип носителя образа.

имя-файла

  Задает Универсальный Уникальный Идентификатор (UUID) или путь к образу диска в файловой системе хоста. UUID можно использовать, только если носитель зарегистрирован. Используйте команду `VBoxManage list hdds` для отображения зарегистрированных образов. Можно указывать как абсолютный, так и относительный пути к носителю.

`--autoreset=on | off`

  Указывает, сбрасывать ли автоматически неизменяемый жесткий диск при каждом старте виртуальной машины (ВМ). Эта опция только для неизменяемых жестких дисков и значение по умолчанию `on`. Смотрите .

`--compact`

  Сжимает образы дисков путем удаления блоков содержащих только нули. Эта опция уменьшает динамически расширяемый образ и уменьшает физический размер образа не влияя на логический размер виртуального диска.

  Можно использовать эту опцию для базовых образов или для разностных образов, созданных как часть снимка.

  Перед сжатием образа, необходимо использовать подходящее ПО для обнуления свободного пространства в гостевой системе. Например:

  - Гости Windows. Запустите команду `sdelete -z`.

  - Гости Linux. Используйте утилиту `zerofree`, которая поддерживает файловые системы `ext2` и `ext3`.

  - Гости Mac OS X. Используйте команду `diskutil secureErase freespace 0 /`.

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

`--description=описание`

  Задает текстовое описание носителя.

`--move=путь`

  Задает относительный или абсолютный путь к носителю в хост-системе. Используйте эту опцию для перемещения носителя в другое расположения в хост-системе.

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

  Задает имя и значение свойства носителя.

`--resize=размер`

  Задает новую емкость существующего образа в МБ. Эту опцию можно использовать только для увеличения емкости образа. Невозможно уменьшить емкость образа.

  Заметим, можно изменить размер только динамически расширяемого диска, использующих форматы VDI и VHD. Эта опция подстраивает логический размер виртуального диска и лишь немного влияет на физический размер.

  Например, если ваш динамически расширяемый 10 ГБ диск полон, можно использовать опцию `--resize 15360` для увеличения емкости существующего диска до 15 ГБ (15360 МБ). Эта операция позволяет избежать создания нового диска и копирования всех данных со старого внутри ВМ.

  Обратите внимание, эта опция меняет емкость диска. Поэтому, может понадобиться воспользоваться впоследствии программой управления разделами в гостевой системе для подгонки разделов под изменившийся размер диска.

`--resizebyte=размер`

  Задает новую емкость существующего образа в байтах. Эта опция подобна опции `--resize`, за исключением того, что размер задается в байтах а не в МБ.

`--setlocation=путь`

  Задает новое расположение носителя в хост-системе после перемещения. Путь может быть как относительно текущей директории так и абсолютным.

  Заметим, что команда `VBoxManage modifymedium` не производит какие-либо проверки указанного пути. Убедитесь, что путь корректен.

`--type`

  Задает новый тип режима существующего образа. Допустимые значения `normal`, `immutable`, `writethrough`, `multi-attach`, `shareable`, and `readonly`. Описание этих типов режимов смотрите в .

## Примеры

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

    $ VBoxManage modifymedium disk disk01.vdi --description "Oracle Linux 7 image"

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

    $ VBoxManage modifymedium disk disk01.vdi --type writethrough

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