File: vmencryption-addpassword.dita

package info (click to toggle)
virtualbox 7.2.2-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 616,072 kB
  • sloc: cpp: 2,377,613; ansic: 2,351,258; asm: 379,359; python: 233,965; xml: 89,678; sh: 25,697; makefile: 8,169; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,785; javascript: 1,692; objc: 1,131; lex: 931; sed: 921; php: 906; yacc: 707
file content (28 lines) | stat: -rw-r--r-- 1,972 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="vmencryption-addpassword">
  <title>Opening the Encrypted VM</title>
  
  <body>
    <p>When <ph conkeyref="vbox-conkeyref-phrases/product-name"/> has just started up the encrypted VM cannot be opened
      and it stays inaccessible. Also, the encrypted VM stays inaccessible if it was just registered without a password
      or the password is incorrect. The user needs to provide the password using <ph
        conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> or with the following <userinput>VBoxManage</userinput> command: </p>
    <pre xml:space="preserve">VBoxManage encryptvm <varname>uuid</varname>|<varname>vmname</varname> addpassword --password <varname>filename</varname>|- --password-id <varname>ID</varname>
                  </pre>
    <p>To supply the encryption password point <userinput>VBoxManage</userinput> to the file where the password is
      stored or specify <codeph>-</codeph> to let <userinput>VBoxManage</userinput> prompt for the password on the
      command line. </p>
    <p>If <varname>ID</varname> is the same as the password identifier supplied when encrypting the VM it updates the
      accessibility state. </p>
    <p>To remove the entered password from the VM memory, use <userinput>VBoxManage</userinput> as follows: </p>
    <pre xml:space="preserve">VBoxManage encryptvm <varname>uuid</varname>|<varname>vmname</varname> removepassword <varname>ID</varname>
                  </pre>
    <p>If <varname>ID</varname> is the same as the password identifier supplied when encrypting the VM it updates the
      accessibility state. </p>
    <note>
      <p>If a machine becomes inaccessible all passwords are purged. You have to add required passwords again, using the <userinput>VBoxManage encryptvm <varname>vmname</varname> addpassword</userinput> command. </p>
    </note>
  </body>
  
</topic>