VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-modifymedium.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: 13.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage modifymedium
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-modifymedium" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage modifymedium</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-modifymedium</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-modifymedium</refname>
44 <refpurpose>изменяет характеристики существующего образа диска</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-modifymedium">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage modifymedium</command>
52 <group>
53 <arg choice="plain">disk</arg>
54 <arg choice="plain">dvd</arg>
55 <arg choice="plain">floppy</arg>
56 </group>
57 <group choice="req">
58 <arg choice="plain"><replaceable>uuid</replaceable></arg>
59 <arg choice="plain"><replaceable>имя-файла</replaceable></arg>
60 </group>
61 <arg>--autoreset=on | off</arg>
62 <arg>--compact</arg>
63 <arg>--description=<replaceable>описание</replaceable></arg>
64 <arg>--move=<replaceable>путь</replaceable></arg>
65 <arg>--property=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</arg>
66 <arg>--resize=<replaceable>мегабайты</replaceable> | --resizebyte=<replaceable>байты</replaceable></arg>
67 <arg>--setlocation=<replaceable>путь</replaceable></arg>
68 <arg>--type=normal | writethrough | immutable | shareable | readonly | multiattach</arg>
69 </cmdsynopsis>
70 </refsynopsisdiv>
71
72 <refsect1>
73 <title>Описание</title>
74 <para>
75 Команда <command>VBoxManage modifymedium</command> позволяет
76 изменить характеристики существующего образа диска.
77 </para>
78 <note>
79 <para>
80 Для совместимости с более ранними версиями &product-name;
81 можно использовать команды <command>modifyvdi</command> и
82 <command>modifyhd</command>.
83 </para>
84 </note>
85 <variablelist>
86 <varlistentry>
87 <term>disk | dvd | floppy</term>
88 <listitem><para>
89 Задает тип носителя образа.
90 </para></listitem>
91 </varlistentry>
92 <varlistentry>
93 <term><replaceable>имя-файла</replaceable></term>
94 <listitem><para>
95 Задает Универсальный Уникальный Идентификатор (UUID) или
96 путь к образу диска в файловой системе хоста. UUID можно
97 использовать, только если носитель зарегистрирован.
98 Используйте команду <command>VBoxManage list hdds</command>
99 для отображения зарегистрированных образов. Можно указывать
100 как абсолютный, так и относительный пути к носителю.
101 </para></listitem>
102 </varlistentry>
103 <varlistentry>
104 <term><option>--autoreset=on | off</option></term>
105 <listitem><para>
106 Указывает, сбрасывать ли автоматически неизменяемый
107 жесткий диск при каждом старте виртуальной машины (ВМ).
108 Эта опция только для неизменяемых жестких дисков и
109 значение по умолчанию <literal>on</literal>.
110 Смотрите <xref linkend="hdimagewrites" />.
111 </para></listitem>
112 </varlistentry>
113 <varlistentry>
114 <term><option>--compact</option></term>
115 <listitem><para>
116 Сжимает образы дисков путем удаления блоков содержащих
117 только нули. Эта опция уменьшает динамически расширяемый
118 образ и уменьшает <emphasis>физический</emphasis> размер
119 образа не влияя на логический размер виртуального диска.
120 </para><para>
121 Можно использовать эту опцию для базовых образов или
122 для разностных образов, созданных как часть снимка.
123 </para><note>
124 <para>
125 Перед сжатием образа, необходимо использовать подходящее
126 ПО для обнуления свободного пространства в гостевой
127 системе. Например:
128 </para>
129 <itemizedlist>
130 <listitem><para>
131 <emphasis role="bold">Гости Windows.</emphasis> Запустите
132 команду <command>sdelete -z</command>.
133 </para></listitem>
134 <listitem><para>
135 <emphasis role="bold">Гости Linux.</emphasis> Используйте
136 утилиту <command>zerofree</command>, которая поддерживает
137 файловые системы <literal>ext2</literal> и
138 <literal>ext3</literal>.
139 </para></listitem>
140 <listitem><para>
141 <emphasis role="bold">Гости Mac OS X.</emphasis> Используйте
142 команду <command>diskutil secureErase freespace 0 /</command>.
143 </para></listitem>
144 </itemizedlist>
145 </note><para>
146 Заметим, что эта опция может использоваться только для
147 сжатия VDI образов. Для сжатия не-VDI образов, можно
148 обнулить свободные блоки и затем клонировать диск в
149 любой другой динамически расширяемый формат.
150 </para></listitem>
151 </varlistentry>
152 <varlistentry>
153 <term><option>--description=<replaceable>описание</replaceable></option></term>
154 <listitem><para>
155 Задает текстовое описание носителя.
156 </para></listitem>
157 </varlistentry>
158 <varlistentry>
159 <term><option>--move=<replaceable>путь</replaceable></option></term>
160 <listitem><para>
161 Задает относительный или абсолютный путь к носителю в
162 хост-системе. Используйте эту опцию для перемещения
163 носителя в другое расположения в хост-системе.
164 </para></listitem>
165 </varlistentry>
166 <varlistentry>
167 <term><option>--property=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term>
168 <listitem><para>
169 Задает имя и значение свойства носителя.
170 </para></listitem>
171 </varlistentry>
172 <varlistentry>
173 <term><option>--resize=<replaceable>размер</replaceable></option></term>
174 <listitem><para>
175 Задает новую емкость существующего образа в МБ. Эту опцию
176 можно использовать только для увеличения емкости образа.
177 Невозможно уменьшить емкость образа.
178 </para><para>
179 Заметим, можно изменить размер только динамически расширяемого
180 диска, использующих форматы VDI и VHD. Эта опция подстраивает
181 <emphasis>логический</emphasis> размер виртуального диска и
182 лишь немного влияет на физический размер.
183 </para><para>
184 Например, если ваш динамически расширяемый 10 ГБ диск полон,
185 можно использовать опцию <option>--resize 15360</option>
186 для увеличения емкости существующего диска до 15 ГБ
187 (15360 МБ). Эта операция позволяет избежать создания нового
188 диска и копирования всех данных со старого внутри ВМ.
189 </para><para>
190 Обратите внимание, эта опция меняет емкость диска. Поэтому,
191 может понадобиться воспользоваться впоследствии программой
192 управления разделами в гостевой системе для подгонки
193 разделов под изменившийся размер диска.
194 </para></listitem>
195 </varlistentry>
196 <varlistentry>
197 <term><option>--resizebyte=<replaceable>размер</replaceable></option></term>
198 <listitem><para>
199 Задает новую емкость существующего образа в байтах.
200 Эта опция подобна опции <option>--resize</option>,
201 за исключением того, что размер задается в байтах а
202 не в МБ.
203 </para></listitem>
204 </varlistentry>
205 <varlistentry>
206 <term><option>--setlocation=<replaceable>путь</replaceable></option></term>
207 <listitem><para>
208 Задает новое расположение носителя в хост-системе после
209 перемещения. Путь может быть как относительно текущей
210 директории так и абсолютным.
211 </para><para>
212 Заметим, что команда <command>VBoxManage modifymedium</command>
213 не производит какие-либо проверки указанного пути. Убедитесь,
214 что путь корректен.
215 </para></listitem>
216 </varlistentry>
217 <varlistentry>
218 <term><option>--type</option></term>
219 <listitem><para>
220 Задает новый тип режима существующего образа. Допустимые
221 значения <literal>normal</literal>,
222 <literal>immutable</literal>,
223 <literal>writethrough</literal>,
224 <literal>multi-attach</literal>,
225 <literal>shareable</literal>, and
226 <literal>readonly</literal>. Описание этих типов режимов
227 смотрите в <xref linkend="hdimagewrites" />.
228 </para></listitem>
229 </varlistentry>
230 </variablelist>
231 </refsect1>
232
233 <refsect1>
234 <title>Примеры</title>
235 <remark role="help-scope" condition="GLOBAL" />
236 <para>
237 Следующая команда изменяет описание файла образа диска, называемого
238 <filename>disk01.vdi</filename>.
239 </para>
240<screen>$ VBoxManage modifymedium disk disk01.vdi --description "Oracle Linux 7 image"</screen>
241 <para>
242 Следующая команда изменяет режим записи для файла образа диска,
243 называемого <filename>disk01.vdi</filename>.
244 </para>
245<screen>$ VBoxManage modifymedium disk disk01.vdi --type writethrough</screen>
246 </refsect1>
247
248 <refsect1>
249 <title>Смотрите также</title>
250 <para>
251 <xref linkend="vboxmanage-list" />
252 </para>
253 </refsect1>
254</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