# VBoxManage encryptmedium

VBoxManage-encryptmedium

1

VBoxManage-encryptmedium

управляет образом или носителем, зашифрованными DEK

&product-name;

          VBoxManage encryptmedium

            uuid
            имя-файла

          --cipher=ID-шифра
          --newpassword=пароль
          --newpasswordid=ID-пароля
          --oldpassword=пароль

## Описание

Команда `VBoxManage encryptmedium` позволяет создавать или управлять образом или носителем, зашифрованными DEK. Можно зашифровать образ, расшифровать образ, изменить пароль шифрования образа. Смотрите diskencryption-encryption.

`uuid` | `имя-файла`

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

`--newpassword=`пароль``

- Задает новый пароль шифрования. `пароль` - это или абсолютный путь к файлу с паролем в хост-системе или `-`. Во втором случае будет предложено ввести пароль.

  Необходимо использовать опцию `--newpasswordid` вместе с этой опцией `--newpassword`.

`--oldpassword=`пароль``

- Задает исходный пароль шифрования. `пароль` - это или абсолютный путь к файлу с паролем в хост-системе или `-`. Во втором случае будет предложено ввести пароль.

  Эта опция позволяет получить доступ к зашифрованному носителю или образу, чтобы произвести следующее:

  - Расшифровать зашифрованный образ используя эту опцию.

  - Изменить пароль зашифрованного образа используя опцию `--newpassword`.

  - Изменить шифр образа используя опцию `--cipher`.

`--cipher=`ID-шифра``

- Указывает шифр для шифрования. Допустимые значения `AES-XTS128-PLAIN64` или `AES-XTS256-PLAIN64`.

  Эта опция позволяет установить или изменить шифрование носителя или образа.

`--newpasswordid=`ID-пароля``

- Указывает новый идентификатор пароля, используемого для корректной идентификации, когда передаются несколько паролей во время старта ВМ.

  Если вы используете одни и те же пароль и идентификатор пароля при шифровании нескольких образов то вам достаточно указать пароль один раз во время старта ВМ.

## Примеры

Следующий пример показывает как зашифровать образ `ol7u4-1.vdi`, используя шифр `AES-XTS128-PLAIN64`, задавая идентификатор пароля `1001` и используя файл пароля `$HOME/pwfile`:

    $ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" \
      --cipher="AES-XTS128-PLAIN64" --newpasswordid="1001" --newpassword=$HOME/pwfile

Следующий пример показывает как расшифровать зашифрованный образ называемый `ol7u4-2.vdi`:

    $ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-2.vdi" \
      --oldpassword=-
      Пароль: исходный-пароль

Следующий пример показывает как изменить пароль зашифрованного образа называемого `ol7u4-3.vdi`. Команда читает исходный пароль из файла `$HOME/pwfile.orig` и назначает идентификатор пароля `1001`.

    $ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-3.vdi" \
      --oldpassword=$HOME/pwfile.orig --newpassword=$HOME/pwfile --newpasswordid="1001"