VirtualBox

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