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