VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-clonevm.xml@ 103068

Last change on this file since 103068 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 12.7 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage clonevm
4-->
5<!--
6 Copyright (C) 2006-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-clonevm" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage clonevm</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-clonevm</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-clonevm</refname>
44 <refpurpose>создание клона существующей виртуальной машины &product-name;</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-clonevm">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage clonevm</command>
52 <arg choice="req"><replaceable>имя-ВМ|uuid</replaceable></arg>
53
54 <arg>--basefolder=<replaceable>основная-папка</replaceable></arg>
55
56 <arg rep="repeat">--groups=<replaceable>группа</replaceable>,</arg>
57
58 <group choice='opt'>
59 <arg choice='plain'>--mode=machine</arg>
60 <arg choice='plain'>--mode=machinechildren</arg>
61 <arg choice='plain'>--mode=all</arg>
62 </group>
63
64 <arg>--name=<replaceable>имя</replaceable></arg>
65
66 <arg rep="repeat">--options=<replaceable>опция</replaceable>,</arg>
67
68 <arg>--register</arg>
69
70 <arg>--snapshot=<replaceable>имя-снимка</replaceable></arg>
71
72 <arg>--uuid=<replaceable>uuid</replaceable></arg>
73 </cmdsynopsis>
74 </refsynopsisdiv>
75
76 <refsect1>
77 <title>Описание</title>
78 <para>
79 Команда <command>VBoxManage clonevm</command> создает клон существующей
80 виртуальной машины (ВМ). Клон может быть либо полной копией ВМ
81 либо связанной копией.
82 </para>
83 <para>
84 Вы должны указать имя или универсальный уникальный идентификатор
85 (UUID) клонируемой машины.
86 </para>
87 </refsect1>
88
89 <refsect1>
90 <title>Командные операнды и опции</title>
91 <para>
92 Следующий список описывает операнды и опции, которые можно использовать
93 с командой <command>VBoxManage clonevm</command>:
94 </para>
95 <variablelist>
96 <varlistentry>
97 <term><replaceable>имя-ВМ|uuid</replaceable></term>
98 <listitem><para>
99 Указывает имя или UUID клонируемой ВМ.
100 </para></listitem>
101 </varlistentry>
102 <varlistentry>
103 <term><option>--basefolder=<replaceable>основная-папка</replaceable></option></term>
104 <listitem><para>
105 Указывает имя папки, в которую сохраняется конфигурация
106 новой ВМ.
107 </para></listitem>
108 </varlistentry>
109 <varlistentry>
110 <term><option>--groups=<replaceable>группа</replaceable>,...</option></term>
111 <listitem><para>
112 Добавляет клон в группу или в группы. Несколько групп
113 указываются через запятую.
114 </para><para>
115 Обратите внимание, что каждая группа идентифицируется по ID
116 группы, начинающийся с символа <computeroutput>/</computeroutput>,
117 поэтому группы могут быть вложенные. По умолчанию, клон
118 всегда добавляется в группу <computeroutput>/</computeroutput>.
119 </para></listitem>
120 </varlistentry>
121 <varlistentry>
122 <term><option>--mode=machine|machineandchildren|all</option></term>
123 <listitem><para>
124 Указывает режим клонирования:
125 </para><itemizedlist>
126 <listitem><para>
127 Режим <computeroutput>machine</computeroutput> клонирует
128 текущее состояние существующей ВМ без снимков. Это
129 режим по умолчанию.
130 </para></listitem>
131 <listitem><para>
132 Режим <computeroutput>machineandchildren</computeroutput>
133 клонирует снимок, указанный через опцию
134 <option>--snapshot</option>, и все его дочерние
135 снимки.
136 </para></listitem>
137 <listitem><para>
138 Режим <computeroutput>all</computeroutput> клонирует
139 все снимки и текущее состояние существующей ВМ.
140 </para></listitem>
141 </itemizedlist></listitem>
142 </varlistentry>
143 <varlistentry>
144 <term><option>--name=<replaceable>имя</replaceable></option></term>
145 <listitem><para>
146 Указывает имя для новой ВМ. Значение по умолчанию - это
147 <computeroutput>Копия <replaceable>исходное-имя</replaceable></computeroutput>,
148 где <replaceable>исходное-имя</replaceable> - это имя
149 исходной ВМ.
150 </para></listitem>
151 </varlistentry>
152 <varlistentry>
153 <term><option>--options=<replaceable>опция</replaceable>,...</option></term>
154 <listitem><para>
155 Указывает как создать новый клон.</para>
156 <para>Аргумент <option>--options</option> может быть использован
157 несколько раз для указания нескольких опций или опции могут быть
158 указаны списком через запятую. Опции не чувствительны к регистру.</para>
159 <para>Распознаются следующие опции (не чувствительны к регистру):</para>
160 <variablelist>
161 <varlistentry>
162 <term><option>Link</option></term>
163 <listitem><para>
164 Создает связанный клон только из снимка.
165 </para></listitem>
166 </varlistentry>
167 <varlistentry>
168 <term><option>KeepAllMACs</option></term>
169 <listitem><para>
170 Указывает, что новый клон использует MAC адреса
171 всех сетевых карт существующей ВМ.
172 </para><para>
173 Если вы не укажете эту опцию или опцию
174 <option>--options=keepnatmacs</option>, то
175 МАС адреса каждой сетевой карты новой ВМ
176 инициализируются новыми значениями.
177 </para></listitem>
178 </varlistentry>
179 <varlistentry>
180 <term><option>KeepNATMACs</option></term>
181 <listitem><para>
182 Указывает, что новый клон использует MAC адреса
183 всех сетевых карт существующей ВМ, если используется
184 сеть типа NAT.
185 </para><para>
186 Если вы не укажете эту опцию или опцию
187 <option>KeepAllMACs</option>, то МАС адреса каждой
188 сетевой карты новой ВМ инициализируются новыми значениями.
189 </para></listitem>
190 </varlistentry>
191 <varlistentry>
192 <term><option>KeepDiskNames</option></term>
193 <listitem><para>
194 Указывает, что новый клон использует те же имена
195 образов дисков что и существующая ВМ. По умолчанию
196 образы дисков переименовываются.
197 </para></listitem>
198 </varlistentry>
199 <varlistentry>
200 <term><option>KeepHwUUIDs</option></term>
201 <listitem><para>
202 Указывает, что новый клон использует идентификаторы
203 аппаратного обеспечения из существующей ВМ. По
204 умолчанию назначаются новые UUID.
205 </para></listitem>
206 </varlistentry>
207 </variablelist></listitem>
208 </varlistentry>
209 <varlistentry>
210 <term><option>--register</option></term>
211 <listitem><para>
212 Автоматически регистрирует новый клон в &product-name;.
213 Позже можно зарегистрировать новую ВМ вручную с помощью
214 команды <command>VBoxManage registervm</command>.
215 Смотрите <xref linkend="vboxmanage-registervm" />.
216 </para></listitem>
217 </varlistentry>
218 <varlistentry>
219 <term><option>--snapshot=<replaceable>имя-снимка</replaceable></option></term>
220 <listitem><para>
221 Указывает снимок, являющийся основой для новой ВМ. По
222 умолчанию клон создается из текущего состояния указанной ВМ.
223 </para></listitem>
224 </varlistentry>
225 <varlistentry>
226 <term><option>--uuid=<replaceable>uuid</replaceable></option></term>
227 <listitem><para>
228 Указывает UUID для новой ВМ. Убедитесь, что ID является
229 уникальным в экземпляре &product-name; если вы решили
230 зарегистрировать новую ВМ. По умолчанию, &product-name;
231 сам назначает новый UUID.
232 </para></listitem>
233 </varlistentry>
234 </variablelist>
235 </refsect1>
236
237 <refsect1>
238 <title>Примеры</title>
239 <para>
240 Следующая команда создает и регистрирует точный клон ВМ
241 <computeroutput>ol7</computeroutput>. Клон называется
242 <computeroutput>ol7-dev-001</computeroutput>.
243 </para>
244 <para>
245 Новый клон включает все снимки исходной ВМ. Новая ВМ использует
246 те же самые MAC адреса всех сетевых интерфейсов, имена дисков
247 и UUIDы исходной ВМ.
248 </para>
249<screen>
250$ VBoxManage clonevm ol7 --name="ol7-dev-001" --register --mode=all \
251 --options=keepallmacs --options=keepdisknames --options=keephwuuids
252</screen>
253 <para>
254 Следующая команда создает и регистрирует клон снимка
255 <computeroutput>Снимок 1</computeroutput> ВМ
256 <computeroutput>ol7</computeroutput>. Клон называется
257 <computeroutput>ol7-dev-002</computeroutput>.
258 </para>
259<screen>
260$ VBoxManage clonevm ol7 --name="ol7-dev-002" --register --snapshot="Снимок 1"
261</screen>
262 </refsect1>
263
264 <refsect1>
265 <title>Смотрите также</title>
266 <para>
267 <xref linkend="vboxmanage-registervm" />
268 </para>
269 </refsect1>
270</refentry>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette