VirtualBox

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

Last change on this file since 103131 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: 10.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage createmedium
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-createmedium" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage createmedium</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-createmedium</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-createmedium</refname>
44 <refpurpose>создает новый носитель</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-createmedium">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage createmedium</command>
52 <group>
53 <arg choice="plain"><replaceable>disk</replaceable></arg>
54 <arg choice="plain"><replaceable>dvd</replaceable></arg>
55 <arg choice="plain"><replaceable>floppy</replaceable></arg>
56 </group>
57 <arg choice="req">--filename=<replaceable>имя-файла</replaceable></arg>
58 <group>
59 <arg choice="plain">--size=<replaceable>мегабайты</replaceable></arg>
60 <arg choice="plain">--sizebyte=<replaceable>байты</replaceable></arg>
61 </group>
62 <arg>--diffparent=<group choice="plain">
63 <arg choice="plain"><replaceable>UUID</replaceable></arg>
64 <arg choice="plain"><replaceable>имя-файла</replaceable></arg>
65 </group></arg>
66 <arg>--format=<group choice="plain">
67 <arg choice="plain"><replaceable>VDI</replaceable></arg>
68 <arg choice="plain"><replaceable>VMDK</replaceable></arg>
69 <arg choice="plain"><replaceable>VHD</replaceable></arg>
70 </group></arg>
71 <arg>--variant Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk</arg>
72 <arg choice="plain" rep="repeat">--property
73 <replaceable>имя</replaceable>=<replaceable>значение</replaceable></arg>
74 <arg choice="plain" rep="repeat">--property-file
75 <replaceable>имя</replaceable>=<replaceable>/путь/к/файлу/со/значением</replaceable></arg>
76 </cmdsynopsis>
77 </refsynopsisdiv>
78
79 <refsect1>
80 <title>Описание</title>
81 <para>
82 Команда <command>VBoxManage createmedium</command> создает новый
83 носитель, такой как файл образа диска.
84 </para>
85 <note>
86 <para>
87 Для совместимости с ранними версиями &product-name; можно
88 использовать команды <command>createvdi</command> и
89 <command>createhd</command> вместо команды
90 <command>createmedium</command>.
91 </para>
92 </note>
93 <variablelist>
94 <varlistentry>
95 <term>disk | dvd | floppy</term>
96 <listitem><para>
97 Указывает тип носителя. Значение по умолчанию
98 <literal>disk</literal>.
99 </para></listitem>
100 </varlistentry>
101 <varlistentry>
102 <term><option>--filename=<replaceable>имя-файла</replaceable></option></term>
103 <listitem><para>
104 Указывает абсолютный путь к файлу в файловой системе хоста.
105 </para></listitem>
106 </varlistentry>
107 <varlistentry>
108 <term><option>--size=<replaceable>мегабайты</replaceable></option></term>
109 <listitem><para>
110 Задает емкость образа в мегабайтах.
111 </para></listitem>
112 </varlistentry>
113 <varlistentry>
114 <term><option>--sizebyte=<replaceable>байты</replaceable></option></term>
115 <listitem><para>
116 Задает емкость образа в байтах.
117 </para></listitem>
118 </varlistentry>
119 <varlistentry>
120 <term><option>--diffparent=<replaceable>UUID</replaceable> | <replaceable>имя-файла</replaceable></option></term>
121 <listitem><para>
122 Указывает Универсальный Уникальный Идентификатор (UUID) или
123 абсолютный путь к родительскому файлу разностного образа в
124 файловой системе хоста.
125 </para><para>
126 Используйте этот файл для совместного использования
127 базового образа диска между ВМ.
128 </para></listitem>
129 </varlistentry>
130 <varlistentry>
131 <term><option>--format=VDI | VMDK | VHD</option></term>
132 <listitem><para>
133 Задает формат выходного файла. Допустимые форматы
134 <literal>VDI</literal>, <literal>VMDK</literal> и
135 <literal>VHD</literal>. Формат по умолчанию
136 <literal>VDI</literal>.
137 </para></listitem>
138 </varlistentry>
139 <varlistentry>
140 <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk</option></term>
141 <listitem><para>
142 Задает варианты формата файла для целевого носителя в
143 виде списка значений разделенных запятыми. Допустимы
144 следующие значения:
145 </para><itemizedlist>
146 <listitem><para>
147 <literal>Standard</literal> - это тип образа диска
148 по умолчанию. Динамически расширяющийся файл.
149 </para></listitem>
150 <listitem><para>
151 <literal>Fixed</literal> использует файл образа диска
152 фиксированного размера.
153 </para></listitem>
154 <listitem><para>
155 <literal>Split2G</literal> показывает, что образ диска
156 разделяется на сегменты по 2 ГБ. Это значение только
157 для VMDK.
158 </para></listitem>
159 <listitem><para>
160 <literal>Stream</literal> оптимизирует образ диска
161 для загрузки. Это значение только для VMDK.
162 </para></listitem>
163 <listitem><para>
164 <literal>ESX</literal> используется в некоторых
165 продуктах VMWare. Это значение только для VMDK.
166 </para></listitem>
167 <listitem><para>
168 <literal>Formatted</literal>
169 </para><para>
170 Только для образов флоппи. Автоматически форматирует
171 носитель.
172 </para></listitem>
173 <listitem><para>
174 <literal>RawDisk</literal> используется для создания
175 raw дисков. Это значение только для VMDK.
176 </para><para>
177
178 </para></listitem>
179 </itemizedlist><para>
180 Заметим, что не все комбинации вариантов допустимы. Указание
181 несовместимых значений вариантов в списке ведет к выдаче
182 сообщения об ошибке.
183 </para></listitem>
184 </varlistentry>
185 <varlistentry>
186 <term><option>--property <replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term>
187 <listitem><para>
188 Задает требуемые параметры, зависящие от формата файла в
189 форме <literal>ключ=значение</literal>. Опционально.
190 </para>
191 </listitem>
192 </varlistentry>
193 <varlistentry>
194 <term><option>--property-file <replaceable>name
195 </replaceable>=<replaceable>/path/to/file/with/value</replaceable></option></term>
196 <listitem><para>
197 Задает требуемые параметры, зависящие от формата файла в
198 форме <literal>key=файл/со/значением</literal>. Значение
199 берется из файла. Опционально.
200 </para></listitem>
201 </varlistentry>
202 </variablelist>
203 </refsect1>
204
205 <refsect1>
206 <title>Примеры</title>
207 <remark role="help-scope" condition="GLOBAL" />
208 <para>
209 Следующая команда создает новый файл образа диска, называемый
210 <filename>disk01.vdi</filename>. Файл имеет размер 1024 мегабайта.
211 </para>
212<screen>$ VBoxManage createmedium --filename disk01.vdi --size 1024</screen>
213 <para>
214 Следующая команда создает новый файл образа флоппи диска, называемый
215 <filename>floppy01.vdi</filename>. Файл имеет размер 1 мегабайт.
216 </para>
217<screen>$ VBoxManage createmedium floppy --filename floppy01.img --size 1</screen>
218 </refsect1>
219</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