| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="customize-vm-selector">
|
|---|
| 4 | <title>VM Selector Customization</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>The following per-machine VM extradata settings can be used to change the behavior of the VM selector window in
|
|---|
| 8 | respect of certain VMs: </p>
|
|---|
| 9 | <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname>
|
|---|
| 10 | <varname>property</varname> true</pre>
|
|---|
| 11 | <p><varname>property</varname> can be any of the following:
|
|---|
| 12 | </p>
|
|---|
| 13 | <dl>
|
|---|
| 14 | <dlentry>
|
|---|
| 15 | <dt>
|
|---|
| 16 | <codeph>GUI/HideDetails</codeph>
|
|---|
| 17 | </dt>
|
|---|
| 18 | <dd>
|
|---|
| 19 | <p>
|
|---|
| 20 | Do not show the VM configuration of a certain VM. The
|
|---|
| 21 | details window will remain just empty if this VM is
|
|---|
| 22 | selected.
|
|---|
| 23 | </p>
|
|---|
| 24 | </dd>
|
|---|
| 25 | </dlentry>
|
|---|
| 26 | <dlentry>
|
|---|
| 27 | <dt>
|
|---|
| 28 | <codeph>GUI/PreventReconfiguration</codeph>
|
|---|
| 29 | </dt>
|
|---|
| 30 | <dd>
|
|---|
| 31 | <p>
|
|---|
| 32 | Do not allow the user to open the
|
|---|
| 33 | <b outputclass="bold">Settings</b> dialog for a
|
|---|
| 34 | certain VM.
|
|---|
| 35 | </p>
|
|---|
| 36 | </dd>
|
|---|
| 37 | </dlentry>
|
|---|
| 38 | <dlentry>
|
|---|
| 39 | <dt>
|
|---|
| 40 | <codeph>GUI/PreventSnapshotOperations</codeph>
|
|---|
| 41 | </dt>
|
|---|
| 42 | <dd>
|
|---|
| 43 | <p>
|
|---|
| 44 | Prevent snapshot operations for a VM from the GUI, either
|
|---|
| 45 | at runtime or when the VM is powered off.
|
|---|
| 46 | </p>
|
|---|
| 47 | </dd>
|
|---|
| 48 | </dlentry>
|
|---|
| 49 | <dlentry>
|
|---|
| 50 | <dt>
|
|---|
| 51 | <codeph>GUI/HideFromManager</codeph>
|
|---|
| 52 | </dt>
|
|---|
| 53 | <dd>
|
|---|
| 54 | <p>
|
|---|
| 55 | Hide a certain VM in the VM selector window.
|
|---|
| 56 | </p>
|
|---|
| 57 | </dd>
|
|---|
| 58 | </dlentry>
|
|---|
| 59 | <dlentry>
|
|---|
| 60 | <dt>
|
|---|
| 61 | <codeph>GUI/PreventApplicationUpdate</codeph>
|
|---|
| 62 | </dt>
|
|---|
| 63 | <dd>
|
|---|
| 64 | <p>
|
|---|
| 65 | Disable the automatic update check and hide the
|
|---|
| 66 | corresponding menu item.
|
|---|
| 67 | </p>
|
|---|
| 68 | </dd>
|
|---|
| 69 | </dlentry>
|
|---|
| 70 | </dl>
|
|---|
| 71 | <p>Note that these settings do not prevent the user from reconfiguring the VM by using the <userinput>VBoxManage
|
|---|
| 72 | modifyvm</userinput> command. </p>
|
|---|
| 73 | </body>
|
|---|
| 74 |
|
|---|
| 75 | </topic>
|
|---|
