VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-snapshot.xml@ 103131

Last change on this file since 103131 was 98103, checked in by vboxsync, 22 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: 16.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage snapshot
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-snapshot" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage snapshot</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-snapshot</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-snapshot</refname>
44 <refpurpose>управляет снимками виртуальной машины &product-name;</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-snapshot">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage snapshot</command>
52 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
53 </cmdsynopsis>
54
55 <cmdsynopsis id="synopsis-vboxmanage-snapshot-take">
56 <command>VBoxManage snapshot</command>
57 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
58
59 <arg choice="plain">take</arg>
60
61 <arg choice="req"><replaceable>имя-снимка</replaceable></arg>
62
63 <arg>--description=<replaceable>описание</replaceable></arg>
64
65 <arg>--live</arg>
66
67 <arg>--uniquename Number,Timestamp,Space,Force</arg>
68 </cmdsynopsis>
69
70 <cmdsynopsis id="synopsis-vboxmanage-snapshot-delete">
71 <command>VBoxManage snapshot</command>
72 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
73
74 <arg choice="plain">delete</arg>
75
76 <arg choice="req"><replaceable>имя-снимка</replaceable></arg>
77 </cmdsynopsis>
78
79 <cmdsynopsis id="synopsis-vboxmanage-snapshot-restore">
80 <command>VBoxManage snapshot</command>
81 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
82
83 <arg choice="plain">restore</arg>
84
85 <arg choice="req"><replaceable>имя-снимка</replaceable></arg>
86 </cmdsynopsis>
87
88 <cmdsynopsis id="synopsis-vboxmanage-snapshot-restorecurrent">
89 <command>VBoxManage snapshot</command>
90 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
91
92 <arg choice="plain">restorecurrent</arg>
93 </cmdsynopsis>
94
95 <cmdsynopsis id="synopsis-vboxmanage-snapshot-edit">
96 <command>VBoxManage snapshot</command>
97 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
98
99 <arg choice="plain">edit</arg>
100
101 <group choice="req">
102 <arg choice="plain"><replaceable>имя-снимка</replaceable></arg>
103 <arg choice="plain">--current</arg>
104 </group>
105
106 <arg>--description=<replaceable>описание</replaceable></arg>
107
108 <arg>--name=<replaceable>новое-имя</replaceable></arg>
109 </cmdsynopsis>
110
111 <cmdsynopsis id="synopsis-vboxmanage-snapshot-list">
112 <command>VBoxManage snapshot</command>
113 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
114
115 <arg choice="plain">list</arg>
116
117 <group><arg>--details</arg><arg>--machinereadable</arg></group>
118 </cmdsynopsis>
119
120 <cmdsynopsis id="synopsis-vboxmanage-snapshot-showvminfo">
121 <command>VBoxManage snapshot</command>
122 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
123
124 <arg choice="plain">showvminfo</arg>
125
126 <arg choice="req"><replaceable>имя-снимка</replaceable></arg>
127 </cmdsynopsis>
128 </refsynopsisdiv>
129
130 <refsect1>
131 <title>Описание</title>
132 <para>
133 Команда <command>VBoxManage snapshot</command> управляет снимками.
134 </para>
135 <para>
136 &product-name; использует снимки для фиксации состояния виртуальной
137 машины (ВМ). Можно позднее использовать снимок для возврата к
138 состоянию, описываемому снимком.
139 </para>
140 <para>
141 Снимок - это полная копия настроек ВМ. Если снимок создается
142 во время работы ВМ, снимок также включает файл состояния ВМ.
143 </para>
144 <para>
145 После создания снимка, &product-name; создает
146 <emphasis>разностный жесткий диск</emphasis> для каждого обычного
147 диска связанного с хост-машиной. При восстановлении снимка,
148 &product-name; использует эти разностные файлы для быстрого
149 сброса содержимого виртуальных жестких дисков ВМ.
150 </para>
151 <para>
152 Для каждой команды <command>VBoxManage snapshot</command>,
153 необходимо указать имя или универсальный уникальный идентификатор
154 (UUID) ВМ для которого нужно сделать снимок.
155 </para>
156 <refsect2>
157 <title>Общие операнды команды</title>
158 <variablelist>
159 <varlistentry>
160 <term><replaceable>uuid|имя-ВМ</replaceable></term>
161 <listitem><para>
162 Задает UUID или имя ВМ.
163 </para></listitem>
164 </varlistentry>
165 </variablelist>
166 </refsect2>
167 <refsect2 id="vboxmanage-snapshot-take">
168 <title>Сделать снимок виртуальной машины</title>
169 <remark role="help-copy-synopsis"/>
170 <para>
171 Команда <command>VBoxManage snapshot take</command> делает
172 снимок текущего состояния ВМ. Необходимо указать имя снимка
173 и, необязательно, описание. Новый снимок вставляется в дерево
174 снимков как потомок текущего снимка и становится новым текущим
175 снимком.
176 </para>
177 <variablelist>
178 <varlistentry>
179 <term><option>--description=<replaceable>описание</replaceable></option></term>
180 <listitem><para>
181 Задает описание снимка.
182 </para></listitem>
183 </varlistentry>
184 <varlistentry>
185 <term><option>--live</option></term>
186 <listitem><para>
187 Указывает, что ВМ не останавливается во время создания
188 снимка. Операция известна как живое создание снимка.
189 </para></listitem>
190 </varlistentry>
191 <varlistentry>
192 <term><option>--uniquename Number,Timestamp,Space,Force</option></term>
193 <listitem><para>
194 Будет описано позже.
195 </para><remark>
196 Что эта опция делает и как ее использовать?
197 </remark></listitem>
198 </varlistentry>
199 <varlistentry>
200 <term><replaceable>имя-снимка</replaceable></term>
201 <listitem><para>
202 Задает имя создаваемого снимка.
203 </para></listitem>
204 </varlistentry>
205 </variablelist>
206 </refsect2>
207 <refsect2 id="vboxmanage-snapshot-delete">
208 <title>Удалить снимок</title>
209 <remark role="help-copy-synopsis"/>
210 <para>
211 Команда <command>VBoxManage snapshot delete</command>
212 удаляет указанный снимок.
213 </para>
214 <para>
215 Операция удаления может занять некоторое время из-за
216 того что разностные образы связанные со снимком могут быть
217 объединены с их дочерними разностными образами.
218 </para>
219 <variablelist>
220 <varlistentry>
221 <term><replaceable>имя-снимка</replaceable></term>
222 <listitem><para>
223 Задает UUID или имя снимка.
224 </para></listitem>
225 </varlistentry>
226 </variablelist>
227 </refsect2>
228 <refsect2 id="vboxmanage-snapshot-restore">
229 <title>Восстановить снимок</title>
230 <remark role="help-copy-synopsis"/>
231 <para>
232 Команда <command>VBoxManage snapshot restore</command>
233 восстанавливает указанный снимок. Эта операция сбрасывает
234 настройки и текущее состояние к указанному снимку. Состояние
235 ВМ, на котором восстанавливается снимок, теряется. По
236 завершении восстановления, указанный снимок становится новым
237 текущим снимком, а последующие снимки - дочерними к нему.
238 </para>
239 <variablelist>
240 <varlistentry>
241 <term><replaceable>имя-снимка</replaceable></term>
242 <listitem><para>
243 Задает UUID или имя снимка.
244 </para></listitem>
245 </varlistentry>
246 </variablelist>
247 </refsect2>
248 <refsect2 id="vboxmanage-snapshot-restorecurrent">
249 <title>Восстановить текущий снимок</title>
250 <remark role="help-copy-synopsis"/>
251 <para>
252 Команда <command>VBoxManage snapshot restorecurrent</command>
253 восстанавливает текущий снимок. Текущий снимок - это снимок,
254 от которого получено текущее состояние. Эта команда
255 эквивалентна команде <command>VBoxManage snapshot
256 restore</command> с указанием имени или UUID текущего снимка.
257 </para>
258 </refsect2>
259 <refsect2 id="vboxmanage-snapshot-edit">
260 <title>Изменить имя или описание существующего снимка</title>
261 <remark role="help-copy-synopsis"/>
262 <para>
263 Команда <command>VBoxManage snapshot edit</command> позволяет
264 изменить имя или описание указанного снимка.
265 </para>
266 <variablelist>
267 <varlistentry>
268 <term><replaceable>имя-снимка</replaceable></term>
269 <listitem><para>
270 Задает UUID или имя редактируемого снимка.
271 </para><para>
272 Эта опция взаимоисключающая с опцией
273 <option>--current</option>.
274 </para></listitem>
275 </varlistentry>
276 <varlistentry>
277 <term><option>--current</option></term>
278 <listitem><para>
279 Указывает, что нужно обновить текущую версию снимка.
280 </para><para>
281 Эта опция взаимоисключающая с указанием имени снимка
282 или его UUID.
283 </para></listitem>
284 </varlistentry>
285 <varlistentry>
286 <term><option>--description=<replaceable>описание</replaceable></option></term>
287 <listitem><para>
288 Задает новое описание для указанного снимка.
289 </para></listitem>
290 </varlistentry>
291 <varlistentry>
292 <term><option>--name=<replaceable>новое-имя</replaceable></option></term>
293 <listitem><para>
294 Задает новое имя снимка.
295 </para></listitem>
296 </varlistentry>
297 </variablelist>
298 </refsect2>
299 <refsect2 id="vboxmanage-snapshot-list">
300 <title>Показать список снимков</title>
301 <remark role="help-copy-synopsis"/>
302 <para>
303 Команда <command>VBoxManage snapshot list</command> показывает
304 все снимки ВМ.
305 </para>
306 <variablelist>
307 <varlistentry>
308 <term><option>--details</option></term>
309 <listitem><para>
310 Указывает, что вывод показывает подробную информацию о снимке.
311 </para><para>
312 Эта опция взаимоисключающая с опцией
313 <option>--machinereadable</option>.
314 </para></listitem>
315 </varlistentry>
316 <varlistentry>
317 <term><option>--machinereadable</option></term>
318 <listitem><para>
319 Указывает, что вывод производится в машино-читаемом
320 формате.
321 </para><para>
322 Эта опция взаимоисключающая с опцией
323 <option>--details</option>.
324 </para></listitem>
325 </varlistentry>
326 </variablelist>
327 </refsect2>
328 <refsect2 id="vboxmanage-snapshot-showvminfo">
329 <title>Показать информацию о настройках снимка</title>
330 <remark role="help-copy-synopsis"/>
331 <para>
332 Команда <command>VBoxManage snapshot showvminfo</command> позволяет
333 просмотреть настройки ВМ, являющихся частью существующего снимка.
334 </para>
335 <variablelist>
336 <varlistentry>
337 <term><replaceable>имя-снимка</replaceable></term>
338 <listitem><para>
339 Задает UUID или имя снимка.
340 </para></listitem>
341 </varlistentry>
342 </variablelist>
343 </refsect2>
344 </refsect1>
345
346 <refsect1>
347 <title>Примеры</title>
348 <remark role="help-scope" condition="GLOBAL"/>
349 <para>
350 Следующая команда создает снимок ВМ
351 <computeroutput>ol7u4</computeroutput>. Снимок называется
352 <computeroutput>ol7u4-snap-001</computeroutput>. Команда использует
353 опцию <option>--description</option> для передачи описания
354 содержимого снимка.
355 </para>
356<screen>
357$ VBoxManage snapshot ol7u4 take ol7u4-snap-001 \
358--description="Oracle Linux 7.4"
359</screen>
360 <para>
361 Следующая команда показывает снимки ВМ
362 <computeroutput>ol7u4</computeroutput>.
363 </para>
364<screen>
365$ VBoxManage snapshot ol7u4 list
366</screen>
367 <para>
368 Следующая команда изменяет описание снимка
369 <computeroutput>ol7u4-snap-001</computeroutput> ВМ
370 <computeroutput>ol7u4</computeroutput>.
371 </para>
372<screen>
373$ VBoxManage snapshot ol7u4 edit ol7u4-snap-001 \
374--description="Oracle Linux 7.4 with UEK4 kernel"
375</screen>
376 <para>
377 Следующая команда показывает настройки ВМ снимка
378 <computeroutput>ol7u1-snap-001</computeroutput> ВМ
379 <computeroutput>ol7u4</computeroutput>.
380 </para>
381<screen>
382$ VBoxManage snapshot ol7u4 showvminfo ol7u4-snap-001
383Имя: ol7u4
384Группы: /
385Гостевая ОС: Oracle (64-bit)
386UUID: 43349d78-2ab3-4cb8-978f-0e755cd98090
387Файл настроек: C:\Users\user1\VirtualBox VMs\ol7u4\ol7u4.vbox
388...
389Снимки:
390
391 Имя: ol7u4-snap-001 (UUID: 1cffc37d-5c37-4b86-b9c5-a0f157a55f43)
392 Описание: Oracle Linux 7.4 with UEK4 kernel
393</screen>
394 </refsect1>
395</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