gui-vmgroups.dita@ 99797

Last change on this file since 99797 was 99797, checked in by vboxsync, 21 months ago
Docs: bugref:10302. Merging changes from the docs team. Almost exclusively conkeyref related stuff.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 3.8 KB

Line
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="gui-vmgroups">
4	<title>Using VM Groups</title>
5
6	<body>
7	<p>
8	VM groups are groups of VMs that you can create as and when
9	required. You can manage and perform functions on them
10	collectively, as well as individually.
11	</p>
12	<p>
13	The following figure shows VM groups displayed in VirtualBox
14	Manager.
15	</p>
16	<fig id="fig-vm-groups">
17	<title>Groups of Virtual Machines</title>
18	<xref href="images/vm-groups.png" format="png" platform="htmlhelp">
19	<image href="images/vm-groups.png" width="10cm" placement="break">
20	<alt>Groups of Virtual Machines</alt>
21	</image>
22	</xref>
23	<image platform="ohc" href="images/vm-groups.png" width="10cm" placement="break">
24	<alt>Groups of Virtual Machines</alt>
25	</image>
26	</fig>
27	<p>
28	The following features are available for groups:
29	</p>
30	<ul>
31	<li>
32	<p>
33	Create a group using <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. Do one of the following:
34	</p>
35	<ul>
36	<li>
37	<p>
38	Drag a VM on top of another VM.
39	</p>
40	</li>
41	<li>
42	<p>
43	Select multiple VMs and select
44	<b outputclass="bold">Group</b> from the
45	right-click menu.
46	</p>
47	</li>
48	</ul>
49	</li>
50	<li>
51	<p>
52	Create and manage a group using the command line. Do one of
53	the following:
54	</p>
55	<ul>
56	<li>
57	<p>
58	Create a group and assign a VM. For example:
59	</p>
60	<pre xml:space="preserve">VBoxManage modifyvm "vm01" --groups "/TestGroup"</pre>
61	<p>
62	This command creates a group <codeph>TestGroup</codeph>
63	and attaches the VM <codeph>vm01</codeph> to that group.
64	</p>
65	</li>
66	<li>
67	<p>
68	Detach a VM from the group, and delete the group if empty.
69	For example:
70	</p>
71	<pre xml:space="preserve">VBoxManage modifyvm "vm01" --groups ""</pre>
72	<p>
73	This command detaches all groups from the VM
74	<codeph>vm01</codeph> and deletes the empty group.
75	</p>
76	</li>
77	</ul>
78	</li>
79	<li>
80	<p>
81	Create multiple groups. For example:
82	</p>
83	<pre xml:space="preserve">VBoxManage modifyvm "vm01" --groups "/TestGroup,/TestGroup2"</pre>
84	<p>
85	This command creates the groups <codeph>TestGroup</codeph>
86	and <codeph>TestGroup2</codeph>, if they do not exist, and
87	attaches the VM <codeph>vm01</codeph> to both of them.
88	</p>
89	</li>
90	<li>
91	<p>
92	Create nested groups, having a group hierarchy. For example:
93	</p>
94	<pre xml:space="preserve">VBoxManage modifyvm "vm01" --groups "/TestGroup/TestGroup2"</pre>
95	<p>
96	This command attaches the VM <codeph>vm01</codeph> to the
97	subgroup <codeph>TestGroup2</codeph> of the
98	<codeph>TestGroup</codeph> group.
99	</p>
100	</li>
101	<li>
102	<p>
103	Use <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> menu options to control and manage all the VMs
104	in a group. For example:
105	<b outputclass="bold">Start</b>,
106	<b outputclass="bold">Pause</b>,
107	<b outputclass="bold">Reset</b>,
108	<b outputclass="bold">Close</b> (save state, send
109	shutdown signal, poweroff), <b outputclass="bold">Discard
110	Saved State</b>, <b outputclass="bold">Show in
111	Explorer</b>, <b outputclass="bold">Sort</b>.
112	</p>
113	</li>
114	</ul>
115	</body>
116
117	</topic>

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format