- Timestamp:
- Jan 11, 2012 3:46:12 PM (13 years ago)
- File:
-
- 1 edited
-
trunk/doc/manual/en_US/user_AdvancedTopics.xml (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/manual/en_US/user_AdvancedTopics.xml
r39406 r39750 1662 1662 <title>Locking down the VirtualBox manager GUI</title> 1663 1663 1664 <para>There are several advanced customization settings for locking down 1665 the VirtualBox manager, that is, removing some features that the user 1666 should not see.<screen>VBoxManage setextradata global GUI/Customizations OPTION[,OPTION...]</screen></para> 1667 1668 <para>where <computeroutput>OPTION</computeroutput> is one of the 1669 following keywords:<glosslist> 1670 <glossentry> 1671 <glossterm><computeroutput>noSelector</computeroutput></glossterm> 1672 1673 <glossdef> 1674 <para>Don't allow to start the VirtualBox manager. Trying to do so 1675 will show a window containing a proper error message.</para> 1676 </glossdef> 1677 </glossentry> 1678 1679 <glossentry> 1680 <glossterm><computeroutput>noMenuBar</computeroutput></glossterm> 1681 1682 <glossdef> 1683 <para>VM windows will not contain a menu bar.</para> 1684 </glossdef> 1685 </glossentry> 1686 1687 <glossentry> 1688 <glossterm><computeroutput>noStatusBar</computeroutput></glossterm> 1689 1690 <glossdef> 1691 <para>VM windows will not contain a status bar.</para> 1692 </glossdef> 1693 </glossentry> 1694 </glosslist></para> 1695 1696 <para>To disable any GUI customization do <screen>VBoxManage setextradata global GUI/Customizations</screen></para> 1697 1698 <para>To disable all host key combinations, open the preferences and 1699 change the host key to <emphasis>None</emphasis>. This might be useful 1700 when using VirtualBox in a kiosk mode.</para> 1701 1702 <para>Furthermore, you can disallow certain actions when terminating a VM. 1703 To disallow specific actions, type:</para> 1704 1705 <para><screen>VBoxManage setextradata "VM name" GUI/RestrictedCloseActions OPTION[,OPTION...]</screen></para> 1706 1707 <para>where <computeroutput>OPTION</computeroutput> is one of the 1708 following keywords:<glosslist> 1709 <glossentry> 1710 <glossterm><computeroutput>SaveState</computeroutput></glossterm> 1711 1712 <glossdef> 1713 <para>Don't allow the user to save the VM state when terminating 1714 the VM.</para> 1715 </glossdef> 1716 </glossentry> 1717 1718 <glossentry> 1719 <glossterm><computeroutput>Shutdown</computeroutput></glossterm> 1720 1721 <glossdef> 1722 <para>Don't allow the user to shutdown the VM by sending the ACPI 1723 power-off event to the guest.</para> 1724 </glossdef> 1725 </glossentry> 1726 1727 <glossentry> 1728 <glossterm><computeroutput>PowerOff</computeroutput></glossterm> 1729 1730 <glossdef> 1731 <para>Don't allow the user to power off the VM.</para> 1732 </glossdef> 1733 </glossentry> 1734 1735 <glossentry> 1736 <glossterm><computeroutput>Restore</computeroutput></glossterm> 1737 1738 <glossdef> 1739 <para>Don't allow the user to return to the last snapshot when 1740 powering off the VM.</para> 1741 </glossdef> 1742 </glossentry> 1743 </glosslist></para> 1744 1745 <para>Any combination of the above is allowed. If all options are 1746 specified, the VM cannot be shut down at all.</para> 1664 <sect2> 1665 <title>GUI customization</title> 1666 1667 <para>There are several advanced customization settings for locking down 1668 the VirtualBox manager, that is, removing some features that the user 1669 should not see.</para> 1670 1671 <para><screen>VBoxManage setextradata global GUI/Customizations OPTION[,OPTION...]</screen></para> 1672 1673 <para>where <computeroutput>OPTION</computeroutput> is one of the 1674 following keywords:<glosslist> 1675 <glossentry> 1676 <glossterm><computeroutput>noSelector</computeroutput></glossterm> 1677 1678 <glossdef> 1679 <para>Don't allow to start the VirtualBox manager. Trying to do so 1680 will show a window containing a proper error message.</para> 1681 </glossdef> 1682 </glossentry> 1683 1684 <glossentry> 1685 <glossterm><computeroutput>noMenuBar</computeroutput></glossterm> 1686 1687 <glossdef> 1688 <para>VM windows will not contain a menu bar.</para> 1689 </glossdef> 1690 </glossentry> 1691 1692 <glossentry> 1693 <glossterm><computeroutput>noStatusBar</computeroutput></glossterm> 1694 1695 <glossdef> 1696 <para>VM windows will not contain a status bar.</para> 1697 </glossdef> 1698 </glossentry> 1699 </glosslist></para> 1700 1701 <para>To disable any GUI customization do <screen>VBoxManage setextradata global GUI/Customizations</screen></para> 1702 </sect2> 1703 1704 <sect2> 1705 <title>Host Key customization</title> 1706 1707 <para>To disable all host key combinations, open the preferences and 1708 change the host key to <emphasis>None</emphasis>. This might be useful 1709 when using VirtualBox in a kiosk mode.</para> 1710 1711 <para>To redefine or disable certain host key actions, use the following command:</para> 1712 1713 <screen>VBoxManage setextradata global GUI/Input/MachineShortcuts "FullscreenMode=F,...."</screen> 1714 1715 <para>The following list shows the possible host key actions together with their default 1716 host key shortcut. Setting an action to <emphasis>None</emphasis> will disable 1717 that host key action.</para> 1718 <table> 1719 <title>ignoreme</title> 1720 <tgroup cols="3"> 1721 <tbody> 1722 <row> 1723 <entry><emphasis role="bold">Action</emphasis></entry> 1724 <entry><emphasis role="bold">Default Host Key</emphasis></entry> 1725 <entry><emphasis role="bold">Action</emphasis></entry> 1726 </row> 1727 <row> 1728 <entry>SettingsDialog</entry> 1729 <entry>S</entry> 1730 <entry>open the VM settings dialog</entry> 1731 </row> 1732 <row> 1733 <entry>TakeSnapshot</entry> 1734 <entry>S</entry> 1735 <entry>take a snapshot</entry> 1736 </row> 1737 <row> 1738 <entry>InformationsDialog</entry> 1739 <entry>N</entry> 1740 <entry>show the VM information dialog</entry> 1741 </row> 1742 <row> 1743 <entry>MouseIntegration</entry> 1744 <entry>I</entry> 1745 <entry>toggle mouse integration</entry> 1746 </row> 1747 <row> 1748 <entry>TypeCAD</entry> 1749 <entry>Del</entry> 1750 <entry>inject Ctrl+Alt+Del</entry> 1751 </row> 1752 <row> 1753 <entry>TypeCABS</entry> 1754 <entry>Backspace</entry> 1755 <entry>inject Ctrl+Alt+Backspace</entry> 1756 </row> 1757 <row> 1758 <entry>Pause</entry> 1759 <entry>P</entry> 1760 <entry>Pause the VM</entry> 1761 </row> 1762 <row> 1763 <entry>Reset</entry> 1764 <entry>R</entry> 1765 <entry>(hard) reset the guest</entry> 1766 </row> 1767 <row> 1768 <entry>Shutdown</entry> 1769 <entry>H</entry> 1770 <entry>press the ACPI power button</entry> 1771 </row> 1772 <row> 1773 <entry>Close</entry> 1774 <entry>Q</entry> 1775 <entry>show the VM close dialog</entry> 1776 </row> 1777 <row> 1778 <entry>FullscreenMode</entry> 1779 <entry>F</entry> 1780 <entry>switch the VM into fullscreen</entry> 1781 </row> 1782 <row> 1783 <entry>SeamlessMode</entry> 1784 <entry>L</entry> 1785 <entry>switch the VM into seamless mode</entry> 1786 </row> 1787 <row> 1788 <entry>ScaleMode</entry> 1789 <entry>C</entry> 1790 <entry>switch the VM into scale mode</entry> 1791 </row> 1792 <row> 1793 <entry>PopupMenu</entry> 1794 <entry>Home</entry> 1795 <entry>show popup menu in fullscreen / seamless mode</entry> 1796 </row> 1797 </tbody> 1798 </tgroup> 1799 </table> 1800 1801 <para>To disable the fullscreen mode as well as the seamless mode, use the following command: 1802 <screen>VBoxManage setextradata global GUI/Input/MachineShortcuts "FullscreenMode=None,SeamlessMode=None"</screen> 1803 </para> 1804 1805 </sect2> 1806 <sect2> 1807 <title>Action when terminating the VM</title> 1808 1809 <para>You can disallow certain actions when terminating a VM. To disallow specific actions, type:</para> 1810 1811 <para><screen>VBoxManage setextradata "VM name" GUI/RestrictedCloseActions OPTION[,OPTION...]</screen></para> 1812 1813 <para>where <computeroutput>OPTION</computeroutput> is one of the 1814 following keywords:<glosslist> 1815 <glossentry> 1816 <glossterm><computeroutput>SaveState</computeroutput></glossterm> 1817 1818 <glossdef> 1819 <para>Don't allow the user to save the VM state when terminating 1820 the VM.</para> 1821 </glossdef> 1822 </glossentry> 1823 1824 <glossentry> 1825 <glossterm><computeroutput>Shutdown</computeroutput></glossterm> 1826 1827 <glossdef> 1828 <para>Don't allow the user to shutdown the VM by sending the ACPI 1829 power-off event to the guest.</para> 1830 </glossdef> 1831 </glossentry> 1832 1833 <glossentry> 1834 <glossterm><computeroutput>PowerOff</computeroutput></glossterm> 1835 1836 <glossdef> 1837 <para>Don't allow the user to power off the VM.</para> 1838 </glossdef> 1839 </glossentry> 1840 1841 <glossentry> 1842 <glossterm><computeroutput>Restore</computeroutput></glossterm> 1843 1844 <glossdef> 1845 <para>Don't allow the user to return to the last snapshot when 1846 powering off the VM.</para> 1847 </glossdef> 1848 </glossentry> 1849 </glosslist></para> 1850 1851 <para>Any combination of the above is allowed. If all options are 1852 specified, the VM cannot be shut down at all.</para> 1853 </sect2> 1747 1854 </sect1> 1748 1855
Note:
See TracChangeset
for help on using the changeset viewer.
