VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-storageattach.xml@ 96301

最後變更 在這個檔案從96301是 96300,由 vboxsync 提交於 3 年 前

doc: comment fixing

  • 屬性 svn:eol-style 設為 native
  • 屬性 svn:keywords 設為 Author Date Id Revision
檔案大小: 29.2 KB
 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage storageattach
4-->
5<!--
6 Copyright (C) 2006-2020 Oracle Corporation
7
8 This file is part of VirtualBox Open Source Edition (OSE), as
9 available from http://www.alldomusa.eu.org. This file is free software;
10 you can redistribute it and/or modify it under the terms of the GNU
11 General Public License (GPL) as published by the Free Software
12 Foundation, in version 2 as it comes in the "COPYING" file of the
13 VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15-->
16<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
17 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
18<!ENTITY % all.entities SYSTEM "all-entities.ent">
19%all.entities;
20]>
21<refentry id="vboxmanage-storageattach" lang="en">
22 <refentryinfo>
23 <pubdate>$Date: 2022-08-18 17:27:14 +0000 (Thu, 18 Aug 2022) $</pubdate>
24 <title>VBoxManage storageattach</title>
25 </refentryinfo>
26
27 <refmeta>
28 <refentrytitle>VBoxManage-storageattach</refentrytitle>
29 <manvolnum>1</manvolnum>
30 </refmeta>
31
32 <refnamediv>
33 <refname>VBoxManage-storageattach</refname>
34 <refpurpose>подключение, удаление и изменение носителей, используемых виртуальной машиной</refpurpose>
35 <refclass>&product-name;</refclass>
36 </refnamediv>
37
38 <refsynopsisdiv>
39 <cmdsynopsis id="synopsis-vboxmanage-storageattach">
40<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
41 <command>VBoxManage storageattach</command>
42 <group choice="req">
43 <arg choice="plain"><replaceable>uuid</replaceable></arg>
44 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
45 </group>
46 <arg choice="req">--storagectl=<replaceable>имя</replaceable></arg>
47 <arg>--bandwidthgroup=<group choice="plain">
48 <arg choice="plain">name</arg>
49 <arg choice="plain">none</arg>
50 </group></arg>
51 <arg>--comment=<replaceable>текст</replaceable></arg>
52 <arg>--device=<replaceable>номер</replaceable></arg>
53 <arg>--discard=<group choice="plain">
54 <arg choice="plain">on</arg>
55 <arg choice="plain">off</arg>
56 </group></arg>
57 <arg>--encodedlun=<replaceable>lun</replaceable></arg>
58 <arg>--forceunmount</arg>
59 <arg>--hotpluggable=<group choice="plain">
60 <arg choice="plain">on</arg>
61 <arg choice="plain">off</arg>
62 </group></arg>
63 <arg>--initiator=<replaceable>инициатор</replaceable></arg>
64 <arg>--intnet</arg>
65 <arg>--lun=<replaceable>lun</replaceable></arg>
66 <arg>--medium=<group choice="plain">
67 <arg choice="plain">none</arg>
68 <arg choice="plain">emptydrive</arg>
69 <arg choice="plain">additions</arg>
70 <arg choice="plain"><replaceable>uuid</replaceable></arg>
71 <arg choice="plain"><replaceable>имя-файла</replaceable></arg>
72 <arg choice="plain">host:<replaceable>диск</replaceable></arg>
73 <arg choice="plain">iscsi</arg>
74 </group></arg>
75 <arg>--mtype=<group choice="plain">
76 <arg choice="plain">normal</arg>
77 <arg choice="plain">writethrough</arg>
78 <arg choice="plain">immutable</arg>
79 <arg choice="plain">shareable</arg>
80 <arg choice="plain">readonly</arg>
81 <arg choice="plain">multiattach</arg>
82 </group></arg>
83 <arg>--nonrotational=<group choice="plain">
84 <arg choice="plain">on</arg>
85 <arg choice="plain">off</arg>
86 </group></arg>
87 <arg>--passthrough=<group choice="plain">
88 <arg choice="plain">on</arg>
89 <arg choice="plain">off</arg>
90 </group></arg>
91 <arg>--passwordfile=<replaceable>файл</replaceable></arg>
92 <arg>--password=<replaceable>пароль</replaceable></arg>
93 <arg>--port=<replaceable>номер</replaceable></arg>
94 <arg>--server=<group choice="plain">
95 <arg choice="plain"><replaceable>имя</replaceable></arg>
96 <arg choice="plain"><replaceable>ip</replaceable></arg>
97 </group></arg>
98 <arg>--setparentuuid=<replaceable>uuid</replaceable></arg>
99 <arg>--setuuid=<replaceable>uuid</replaceable></arg>
100 <arg>--target=<replaceable>цель</replaceable></arg>
101 <arg>--tempeject=<group choice="plain">
102 <arg choice="plain">on</arg>
103 <arg choice="plain">off</arg>
104 </group></arg>
105 <arg>--tport=<replaceable>порт</replaceable></arg>
106 <arg>--type=<group choice="plain">
107 <arg choice="plain">dvddrive</arg>
108 <arg choice="plain">fdd</arg>
109 <arg choice="plain">hdd</arg>
110 </group></arg>
111 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
112 </cmdsynopsis>
113 </refsynopsisdiv>
114
115 <refsect1>
116 <title>Описание</title>
117 <para>
118 Команда <command>VBoxManage storageattach</command> позволяет
119 управлять носителями, подключенными к контроллеру через команду
120 <command>VBoxManage storagectl</command>.
121 </para>
122 <variablelist>
123 <varlistentry>
124 <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term>
125 <listitem><para>
126 Задает Универсальный Уникальный Идентификатор (UUID) или
127 имя виртуальной машины (ВМ).
128 </para></listitem>
129 </varlistentry>
130 <varlistentry>
131 <term><option>--storagectl=<replaceable>имя</replaceable></option></term>
132 <listitem><para>
133 Задает имя контроллера. Используйте команду
134 <command>VBoxManage showvminfo</command> для просмотра
135 подключенных к ВМ контроллеров.
136 </para></listitem>
137 </varlistentry>
138 <varlistentry>
139 <term><option>--port=<replaceable>номер</replaceable></option></term>
140 <listitem><para>
141 Задает номер порта изменяемого контроллера. Необходимо
142 использовать эту опцию если у контроллера несколько портов.
143 </para></listitem>
144 </varlistentry>
145 <varlistentry>
146 <term><option>--device=<replaceable>номер</replaceable></option></term>
147 <listitem><para>
148 Задает номер устройства изменяемого порта. Необходимо
149 использовать эту опцию если у контроллера несколько
150 устройств на порт.
151 </para></listitem>
152 </varlistentry>
153 <varlistentry>
154 <term><option>--type=dvddrive | fdd | hdd</option></term>
155 <listitem><para>
156 Указывает тип диска, с которым связан носитель.
157 Опустить данный параметр можно только если тип носителя
158 может быть определен через опцию <option>--medium</option>
159 или через информацию, переданную более ранней командой
160 подключения носителя.
161 </para></listitem>
162 </varlistentry>
163 <varlistentry>
164 <term><option>--medium=none | emptydrive | additions | <replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable> | host:<replaceable>диск</replaceable> | iscsi</option></term>
165 <listitem><para>
166 Задает одно из следующих значений:
167 </para><variablelist>
168 <varlistentry>
169 <term><literal>none</literal></term>
170 <listitem><para>
171 Удаляет любой существующее устройство из указанного слота.
172 </para></listitem>
173 </varlistentry>
174 <varlistentry>
175 <term><literal>emptydrive</literal></term>
176 <listitem><para>
177 Только для виртуальных DVD или флоппи дисков.
178 </para><para>
179 Заставляет слот устройства вести себя как съемный
180 диск, в который не вставлен носитель.
181 </para></listitem>
182 </varlistentry>
183 <varlistentry>
184 <term><literal>additions</literal></term>
185 <listitem><para>
186 Только для виртуальных DVD дисков.
187 </para><para>
188 Подключает образ Дополнений Гостевой ОС VirtualBox
189 в указанный слот устройств.
190 </para></listitem>
191 </varlistentry>
192 <varlistentry>
193 <term><replaceable>uuid</replaceable></term>
194 <listitem><para>
195 Задает UUID носителя для подключения в указанный слот
196 устройства. Носитель должен быть уже известен
197 &product-name;, например носитель, подключенный к
198 другой ВМ. Используйте команду
199 <command>VBoxManage list</command> для просмотра
200 носителей.
201 </para></listitem>
202 </varlistentry>
203 <varlistentry>
204 <term><replaceable>имя-файла</replaceable></term>
205 <listitem><para>
206 Задает полный путь к существующему образу диска
207 для подключения к указанному слоту устройства.
208 Образ диска может быть ISO, RAW, VDI, VMDK или
209 другого формата.
210 </para></listitem>
211 </varlistentry>
212 <varlistentry>
213 <term><literal>host:<replaceable>диск</replaceable></literal></term>
214 <listitem><para>
215 Только для виртуальных DVD или флоппи дисков.
216 </para><para>
217 Соединяет указанный слот устройства к указанному
218 DVD или флоппи диску хост-компьютера.
219 </para></listitem>
220 </varlistentry>
221 <varlistentry>
222 <term><literal>iscsi</literal></term>
223 <listitem><para>
224 Только для виртуальных жестких дисков.
225 </para><para>
226 Задает цель iSCSI, для которой необходимо указать
227 дополнительную информацию. Смотрите
228 <xref linkend="storage-iscsi" />.
229 </para></listitem>
230 </varlistentry>
231 </variablelist><para>
232 Для съемных дисков, таких как флоппи и DVD, можно менять
233 настройки во время выполнения ВМ. Изменения устройств или
234 слотов устройств жестких дисков требуют, чтобы ВМ была
235 выключена.
236 </para></listitem>
237 </varlistentry>
238 <varlistentry>
239 <term><option>--mtype=normal | writethrough | immutable | shareable | readonly | multiattach</option></term>
240 <listitem><para>
241 Указывает, как носитель ведет себя по отношению к снимкам
242 и операциям записи. Смотрите <xref linkend="hdimagewrites" />.
243 </para></listitem>
244 </varlistentry>
245 <varlistentry>
246 <term><option>--comment=<replaceable>текст</replaceable></option></term>
247 <listitem><para>
248 Задает необязательное описание, сохраняемое с носителем.
249 </para></listitem>
250 </varlistentry>
251 <varlistentry>
252 <term><option>--setuuid=<replaceable>uuid</replaceable></option></term>
253 <listitem><para>
254 Изменяет UUID носителя перед подключением к ВМ.
255 </para><para>
256 Это экспертная опция. Неподходящие значения могут привести
257 к невозможности использовать носитель или к поломке
258 настроек ВМ если другая ВМ уже ссылается на такой же носитель.
259 </para><para>
260 Опция <option>--setuuid=""</option> назначает
261 новый случайный UUID образу, что может убрать ошибку
262 дублированного UUID, если была использована утилита
263 файлового копирования для дублирования образа.
264 </para></listitem>
265 </varlistentry>
266 <varlistentry>
267 <term><option>--setparentuuid=<replaceable>uuid</replaceable></option></term>
268 <listitem><para>
269 Изменяет родительский UUID носителя перед подключением к ВМ.
270 </para><para>
271 Это экспертная опция. Неподходящие значения могут привести
272 к невозможности использовать носитель или к поломке
273 настроек ВМ если другая ВМ уже ссылается на такой же носитель.
274 </para></listitem>
275 </varlistentry>
276 <varlistentry>
277 <term><option>--passthrough=on | off</option></term>
278 <listitem><para>
279 Только для виртуальных DVD дисков.
280 </para><para>
281 Включает запись на DVD. Эта функция экспериментальная.
282 Смотрите <xref linkend="storage-cds" />.
283 </para></listitem>
284 </varlistentry>
285 <varlistentry>
286 <term><option>--tempeject=on | off</option></term>
287 <listitem><para>
288 Только для виртуальных DVD дисков.
289 </para><para>
290 Указывает, разрешать ли операцию временного извлечения
291 носителя по запросу гостевой системы. Если установлено
292 в <literal>on</literal>, носитель может быть извлечен.
293 Возможность операции извлечения по запросу гостевой
294 системы, не сохраняется, если ВМ выключена и
295 перезапущена. Таким образом, когда опция установлена
296 в <literal>on</literal> и ВМ перезапущена, первоначально
297 настроенный носитель все еще в дисководе.
298 </para></listitem>
299 </varlistentry>
300 <varlistentry>
301 <term><option>--nonrotational=on | off</option></term>
302 <listitem><para>
303 Позволяет указать, что виртуальный жесткий диск
304 не вращается. Некоторые гостевые ОС, например Windows 7
305 и более поздние, считают такие диски твердотельными (SSD)
306 и не производят фрагментацию диска на них.
307 </para></listitem>
308 </varlistentry>
309 <varlistentry>
310 <term><option>--discard=on | off</option></term>
311 <listitem><para>
312 Указывает, включать ли функцию автоудаления для виртуального
313 жесткого диска. Когда установлена в <literal>on</literal>,
314 образ VDI уменьшается в ответ на команду <command>trim</command>
315 гостевой ОС.
316 </para><para>
317 Виртуальный жесткий диск должен удовлетворять следующим
318 требованиям:
319 </para><itemizedlist>
320 <listitem><para>
321 Формат диска должен быть VDI.
322 </para></listitem>
323 <listitem><para>
324 Размер очищаемой области диска должен быть не менее 1 МБ.
325 </para></listitem>
326 <listitem><para>
327 Убедитесь, что обрезаемое пространство представляет
328 собой непрерывный блок размером не менее 1 МБ на
329 границе 1 МБ.
330 </para></listitem>
331 </itemizedlist><para>
332 Рассмотрите запуск команд дефрагментации в фоновом режиме
333 через cron для сохранения пространства. В Windows
334 запускайте команду <command>defrag.exe /D</command>. В
335 Linux запускайте команду <command>btrfs filesystem
336 defrag</command>.
337 </para><note>
338 <para>
339 При настройке гостевой ОС для выдачи команды
340 <command>trim</command>, гостевая ОС обычно рассматривает
341 диск как SSD.
342 </para>
343 <para>
344 Ext4 поддерживает опцию монтирования
345 <option>-o discard</option>. В Mac OS X может
346 потребоваться дополнительная настройка. Windows 7, 8
347 и 10 автоматически определяет и поддерживает SSD.
348 Драйвер Linux <command>exFAT</command> от Samsung
349 поддерживает команду <command>trim</command>.
350 </para>
351 </note><para>
352 Реализация exFAT от Microsoft может не поддерживать эту
353 функцию.
354 </para><para>
355 Можно использовать другие способы для выдачи команд trim.
356 Команда Linux <command>fstrim</command> является частью
357 пакета <filename>util-linux</filename>. Ранние решения
358 требовали обнулить неиспользуемые области через команду
359 <command>zerofree</command> или подобную, затем уплотнить
360 диск. Можно производит данные шаги только при выключенной
361 ВМ.
362 </para></listitem>
363 </varlistentry>
364 <varlistentry>
365 <term><option>--bandwidthgroup=<replaceable>имя</replaceable></option></term>
366 <listitem><para>
367 Задает группу полосы пропускания, используемую в устройстве.
368 Смотрите <xref linkend="storage-bandwidth-limit" />.
369 </para></listitem>
370 </varlistentry>
371 <varlistentry>
372 <term><option>--forceunmount</option></term>
373 <listitem><para>
374 Только для виртуальных DVD или флоппи дисков.
375 </para><para>
376 Принудительно размонтирует DVD, CD, или флоппи или
377 монтирует новый DVD, CD, или флоппи даже если предыдущий
378 съемный носитель заблокирован гостем на чтение. Смотрите
379 <xref linkend="storage-cds" />.
380 </para></listitem>
381 </varlistentry>
382 </variablelist>
383 <para>
384 Следующие опции применимы когда указана опция
385 <option>--medium=iscsi</option>:
386 </para>
387 <variablelist>
388 <varlistentry>
389 <term><option>--server=<replaceable>имя-хоста</replaceable> | <replaceable>IP-адрес</replaceable></option></term>
390 <listitem><para>
391 Задает имя хоста или IP адрес цели iSCSI.
392 </para></listitem>
393 </varlistentry>
394 <varlistentry>
395 <term><option>--target=<replaceable>цель</replaceable></option></term>
396 <listitem><para>
397 Задает строку имени цели, определяемую целью
398 iSCSI и используется для идентификации ресурса хранилища.
399 </para></listitem>
400 </varlistentry>
401 <varlistentry>
402 <term><option>--tport=<replaceable>порт</replaceable></option></term>
403 <listitem><para>
404 Задает номер порта TCP/IP службы iSCSI цели.
405 </para></listitem>
406 </varlistentry>
407 <varlistentry>
408 <term><option>--lun=<replaceable>LUN</replaceable></option></term>
409 <listitem><para>
410 Задает номер логической единицы ресурса цели.
411 Для единственного дисковода значение равно нулю.
412 </para></listitem>
413 </varlistentry>
414 <varlistentry>
415 <term><option>--encodedlun=<replaceable>LUN</replaceable></option></term>
416 <listitem><para>
417 Задает LUN ресурса цели в виде закодированную в
418 шестнадцатеричном виде. Для единственного дисковода
419 значение равно нулю.
420 </para></listitem>
421 </varlistentry>
422 <varlistentry>
423 <term><option>--username=<replaceable>имя-пользователя</replaceable></option></term>
424 <listitem><para>
425 Задает имя пользователя для аутентификации цели.
426 </para><note>
427 <para>
428 Если не установлен пароль на настройки, имя пользователя
429 сохраняется в виде простого текста в XML файле настроек
430 машины.
431 </para>
432 </note></listitem>
433 </varlistentry>
434 <varlistentry>
435 <term><option>--password=<replaceable>пароль</replaceable></option></term>
436 <listitem><para>
437 Задает пароль для аутентификации цели.
438 </para><note>
439 <para>
440 Если не установлен пароль на настройки, этот пароль
441 сохраняется в виде простого текста в XML файле
442 конфигурации машины. Когда пароль на настройки
443 установлен, пароль аутентификации цели сохраняется
444 в шифрованном виде.
445 </para>
446 </note><remark>
447 Этот дизайн не соответствует рекомендациям по безопасности
448 Oracle. У Вас не должно быть возможности указать пароль
449 в командной строке, так как пароль может быть увиден
450 в списке процессов.
451 </remark></listitem>
452 </varlistentry>
453 <varlistentry>
454 <term><option>--passwordfile=<replaceable>файл-с-паролем</replaceable></option></term>
455 <listitem><para>
456 Задает файл, содержащий пароль аутентификации цели
457 в виде простого текста.
458 </para><note>
459 <para>
460 Используйте настройки разрешений и владения, чтобы
461 убедиться, что содержимое этого файла не могут прочитать
462 неавторизованные пользователи.
463 </para>
464 </note></listitem>
465 </varlistentry>
466 <varlistentry>
467 <term><option>--initiator=<replaceable>инициатор</replaceable></option></term>
468 <listitem><para>
469 Задает инициатор iSCSI.
470 </para><para>
471 iSCSI инициатор от Microsoft - это система, например сервер,
472 которая подключается к IP сети и инициирует запросы и
473 получает ответы от iSCSI целей. SAN компоненты в
474 инициаторе iSCSI во многом аналогичны SAN компонентам Fibre
475 Channel и включают следующие:
476 </para><itemizedlist>
477 <listitem><para>
478 <emphasis role="bold">Драйвер iSCSI.</emphasis>
479 Траспортирует блоки команд iSCSI через сеть IP. Этот
480 драйвер iSCSI устанавливается в хост iSCSI и входит
481 в состав инициатор iSCSI от Microsoft.
482 </para></listitem>
483 <listitem><para>
484 <emphasis role="bold">Адаптер Gigabit Ethernet.</emphasis>
485 Подключается к цели iSCSI. Используйте адаптер
486 Ethernet, который может передавать 1000 мегабит в
487 секунду (Мб/с). Как и стандартные 10/100 адаптеры,
488 большинство гигабитных адаптеров используют
489 существующие кабели категории 5 или 6Е. Каждый порт
490 адаптера идентифицируется уникальным IP адресом.
491 </para></listitem>
492 <listitem><para>
493 <emphasis role="bold">Цель iSCSI.</emphasis> Это любое
494 устройство, которое получает команды iSCSI. Устройством
495 может быть как конечный узел, например устройство хранения,
496 так и промежуточное устройство, например сетевой мост
497 между устройствами IP и Fibre Channel. Каждый порт
498 контроллера массива хранилищ или сетевого моста
499 идентифицируется одним или несколькими IP адресами.
500 </para></listitem>
501 </itemizedlist></listitem>
502 </varlistentry>
503 <varlistentry>
504 <term><option>--intnet</option></term>
505 <listitem><para>
506 Указывает, подключаться ли к цели iSCSI, использующую
507 внутреннюю сеть. Эта настройка требует дальнейшую
508 настройку. Смотрите <xref linkend="iscsi-intnet" />.
509 </para></listitem>
510 </varlistentry>
511 </variablelist>
512 </refsect1>
513
514 <refsect1>
515 <title>Примеры</title>
516 <remark role="help-scope" condition="GLOBAL" />
517 <para>
518 Следующая команда подключает образ диска <filename>o7.vdi</filename>
519 к указанному контроллеру SATA в ВМ <filename>ol7</filename>.
520 </para>
521<screen>$ storageattach ol7 --storagectl "SATA Controller" --port 0 --device 0 \
522--type hdd --medium /VirtualBox/ol7/ol7.vdi</screen>
523 <para>
524 Следующая команда подключает образ DVD <filename>o7-r6-dvd.iso</filename>
525 к указанному контроллеру IDE в ВМ <filename>ol7</filename>.
526 </para>
527<screen>$ VBoxManage storageattach ol7 --storagectl "IDE Controller" --port 0 --device 0 \
528--type dvddrive --medium ol7-r6-dvd.iso</screen>
529 </refsect1>
530
531 <refsect1>
532 <title>Смотрите также</title>
533 <para>
534 <xref linkend="vboxmanage-list" />,
535 <xref linkend="vboxmanage-showvminfo" />,
536 <xref linkend="vboxmanage-storagectl" />
537 </para>
538 </refsect1>
539</refentry>
注意: 瀏覽 TracBrowser 來幫助您使用儲存庫瀏覽器

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