File: terminate-vm-action.dita

package info (click to toggle)
virtualbox 7.1.12-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 565,672 kB
  • sloc: ansic: 2,330,854; cpp: 2,193,228; asm: 230,777; python: 223,895; xml: 86,771; sh: 25,541; makefile: 8,158; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,782; javascript: 1,692; objc: 1,131; lex: 931; php: 906; sed: 899; yacc: 707
file content (57 lines) | stat: -rw-r--r-- 1,876 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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="terminate-vm-action">
  <title>Action when Terminating the VM</title>
  
  <body>
    <p>You can disallow certain actions when terminating a VM. To disallow specific actions, use the following command: </p>
    <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> GUI/RestrictedCloseActions <varname>property</varname>[,<varname>property</varname>...]</pre>
    <p><varname>property</varname> is one of the following:
      </p>
    <dl>
      <dlentry>
        <dt>
          <codeph>SaveState</codeph>
        </dt>
        <dd>
          <p>Do not allow the user to save the VM state when terminating the VM. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>
          <codeph>Shutdown</codeph>
        </dt>
        <dd>
          <p>Do not allow the user to shutdown the VM by sending the ACPI power-off event to the guest. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>
          <codeph>PowerOff</codeph>
        </dt>
        <dd>
          <p>Do not allow the user to power off the VM. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>
          <codeph>PowerOffRestoringSnapshot</codeph>
        </dt>
        <dd>
          <p>Do not allow the user to return to the last snapshot when powering off the VM. </p>
        </dd>
      </dlentry>
      <dlentry>
        <dt>
          <codeph>Detach</codeph>
        </dt>
        <dd>
          <p>Do not allow the user to detach from the VM process if the VM was started in separate mode. </p>
        </dd>
      </dlentry>
    </dl>
    <p>This is a per-VM setting. You can specify any combination of properties. If all properties are specified, the VM
      cannot be shut down. </p>
  </body>
  
</topic>