# VBoxManage snapshot

VBoxManage-snapshot

1

VBoxManage-snapshot

управляет снимками виртуальной машины &product-name;

&product-name;

          VBoxManage snapshot
          uuid|имя-ВМ

          VBoxManage snapshot
          uuid|имя-ВМ

          take

          имя-снимка

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

          --live

          --uniquename Number,Timestamp,Space,Force

          VBoxManage snapshot
          uuid|имя-ВМ

          delete

          имя-снимка

          VBoxManage snapshot
          uuid|имя-ВМ

          restore

          имя-снимка

          VBoxManage snapshot
          uuid|имя-ВМ

          restorecurrent

          VBoxManage snapshot
          uuid|имя-ВМ

          edit

            имя-снимка
            --current

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

          --name=новое-имя

          VBoxManage snapshot
          uuid|имя-ВМ

          list

          --details--machinereadable

          VBoxManage snapshot
          uuid|имя-ВМ

          showvminfo

          имя-снимка

## Описание

Команда `VBoxManage snapshot` управляет снимками.

&product-name; использует снимки для фиксации состояния виртуальной машины (ВМ). Можно позднее использовать снимок для возврата к состоянию, описываемому снимком.

Снимок - это полная копия настроек ВМ. Если снимок создается во время работы ВМ, снимок также включает файл состояния ВМ.

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

Для каждой команды `VBoxManage snapshot`, необходимо указать имя или универсальный уникальный идентификатор (UUID) ВМ для которого нужно сделать снимок.

### Общие операнды команды

`uuid|имя-ВМ`

- Задает UUID или имя ВМ.

### Сделать снимок виртуальной машины

Команда `VBoxManage snapshot take` делает снимок текущего состояния ВМ. Необходимо указать имя снимка и, необязательно, описание. Новый снимок вставляется в дерево снимков как потомок текущего снимка и становится новым текущим снимком.

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

- Задает описание снимка.

`--live`

- Указывает, что ВМ не останавливается во время создания снимка. Операция известна как живое создание снимка.

`--uniquename Number,Timestamp,Space,Force`

- Будет описано позже.

`имя-снимка`

- Задает имя создаваемого снимка.

### Удалить снимок

Команда `VBoxManage snapshot delete` удаляет указанный снимок.

Операция удаления может занять некоторое время из-за того что разностные образы связанные со снимком могут быть объединены с их дочерними разностными образами.

`имя-снимка`

- Задает UUID или имя снимка.

### Восстановить снимок

Команда `VBoxManage snapshot restore` восстанавливает указанный снимок. Эта операция сбрасывает настройки и текущее состояние к указанному снимку. Состояние ВМ, на котором восстанавливается снимок, теряется. По завершении восстановления, указанный снимок становится новым текущим снимком, а последующие снимки - дочерними к нему.

`имя-снимка`

- Задает UUID или имя снимка.

### Восстановить текущий снимок

Команда `VBoxManage snapshot restorecurrent` восстанавливает текущий снимок. Текущий снимок - это снимок, от которого получено текущее состояние. Эта команда эквивалентна команде `VBoxManage snapshot restore` с указанием имени или UUID текущего снимка.

### Изменить имя или описание существующего снимка

Команда `VBoxManage snapshot edit` позволяет изменить имя или описание указанного снимка.

`имя-снимка`

- Задает UUID или имя редактируемого снимка.

  Эта опция взаимоисключающая с опцией `--current`.

`--current`

- Указывает, что нужно обновить текущую версию снимка.

  Эта опция взаимоисключающая с указанием имени снимка или его UUID.

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

- Задает новое описание для указанного снимка.

`--name=`новое-имя``

- Задает новое имя снимка.

### Показать список снимков

Команда `VBoxManage snapshot list` показывает все снимки ВМ.

`--details`

- Указывает, что вывод показывает подробную информацию о снимке.

  Эта опция взаимоисключающая с опцией `--machinereadable`.

`--machinereadable`

- Указывает, что вывод производится в машино-читаемом формате.

  Эта опция взаимоисключающая с опцией `--details`.

### Показать информацию о настройках снимка

Команда `VBoxManage snapshot showvminfo` позволяет просмотреть настройки ВМ, являющихся частью существующего снимка.

`имя-снимка`

- Задает UUID или имя снимка.

## Примеры

Следующая команда создает снимок ВМ `ol7u4`. Снимок называется `ol7u4-snap-001`. Команда использует опцию `--description` для передачи описания содержимого снимка.

    $ VBoxManage snapshot ol7u4 take ol7u4-snap-001 \
    --description="Oracle Linux 7.4"

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

    $ VBoxManage snapshot ol7u4 list

Следующая команда изменяет описание снимка `ol7u4-snap-001` ВМ `ol7u4`.

    $ VBoxManage snapshot ol7u4 edit ol7u4-snap-001 \
    --description="Oracle Linux 7.4 with UEK4 kernel"

Следующая команда показывает настройки ВМ снимка `ol7u1-snap-001` ВМ `ol7u4`.

    $ VBoxManage snapshot ol7u4 showvminfo ol7u4-snap-001
    Имя:            ol7u4
    Группы:          /
    Гостевая ОС:        Oracle (64-bit)
    UUID:            43349d78-2ab3-4cb8-978f-0e755cd98090
    Файл настроек:     C:\Users\user1\VirtualBox VMs\ol7u4\ol7u4.vbox
    ...
    Снимки:

       Имя: ol7u4-snap-001 (UUID: 1cffc37d-5c37-4b86-b9c5-a0f157a55f43)
       Описание: Oracle Linux 7.4 with UEK4 kernel