summaryrefslogtreecommitdiffstats
path: root/doc/manual/ru_RU/man_VBoxManage-startvm.xml
blob: 2ade937486bdccfeea002418533796c27f316d5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<?xml version="1.0" encoding="UTF-8"?>
<!--
    manpage, user manual, usage: VBoxManage startvm
-->
<!--
    Copyright (C) 2006-2023 Oracle and/or its affiliates.

    This file is part of VirtualBox base platform packages, as
    available from https://www.virtualbox.org.

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License
    as published by the Free Software Foundation, in version 3 of the
    License.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, see <https://www.gnu.org/licenses>.

    SPDX-License-Identifier: GPL-3.0-only
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
<!ENTITY % all.entities SYSTEM "all-entities.ent">
%all.entities;
]>
<refentry id="vboxmanage-startvm" lang="en">
  <refentryinfo>
    <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate>
    <title>VBoxManage startvm</title>
  </refentryinfo>

  <refmeta>
    <refentrytitle>VBoxManage-startvm</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>VBoxManage-startvm</refname>
    <refpurpose>запуск виртуальной машины</refpurpose>
    <refclass>&product-name;</refclass>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis id="synopsis-vboxmanage-startvm">
<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
      <command>VBoxManage startvm</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg>--putenv=<replaceable>имя</replaceable>[=<replaceable>значение</replaceable>]</arg>
      <arg>--type=<group>
          <arg choice="plain">gui</arg>
          <arg choice="plain">headless</arg>
          <arg choice="plain">sdl</arg>
          <arg choice="plain">separate</arg>
        </group></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Описание</title>
    <para>
      Команда <command>VBoxManage startvm</command> запускает
      виртуальную машину &product-name; (ВМ), которая в состоянии
      &quot;Выключено&quot; или &quot;Состояние сохранено&quot;.
    </para>
    <variablelist>
      <varlistentry>
        <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term>
        <listitem><para>
            Задает имя или Универсальный Уникальный Идентификатор
            (UUID) ВМ.
          </para></listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--putenv=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term>
        <listitem><para>
            Назначает значение переменной окружения в виде пары
            имя-значение. Например VBOX_DISABLE_HOST_DISK_CACHE=1.
          </para><para>
            Кратка форма этой опции <option>-E</option>.
          </para></listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--type=gui | headless | sdl | separate</option></term>
        <listitem><para>
            Указывает фронтенд запускаемой ВМ.
          </para><para>
            Можно использовать команду <command>VBoxManage setproperty</command>
            для установки фронтенда по умолчанию как глобального
            значения. Альтернативно, можно использовать команду
            <command>VBoxManage modifyvm</command> для указания
            фронтенда по умолчанию для определенной ВМ. Если не
            установлено значение по умолчанию ни глобально, ни
            для указанной ВМ и не указана опция <option>--type</option>,
            ВМ открывается в окне рабочего стола хоста.
          </para><para>
            Опция <option>--type</option> принимает следующие
            значения:
          </para><variablelist>
            <varlistentry>
              <term><literal>gui</literal></term>
              <listitem><para>
                  Запускает ВМ в окне графического интерфейса
                  пользователя. Это значение по умолчанию.
                </para></listitem>
            </varlistentry>
            <varlistentry>
              <term><literal>headless</literal></term>
              <listitem><para>
                  Фоновый режим. Запускает ВМ только для
                  удаленного дисплея.
                </para></listitem>
            </varlistentry>
            <varlistentry>
              <term><literal>sdl</literal></term>
              <listitem><para>
                  Запускает ВМ, используя фронтенд VBoxSDL.
                </para></listitem>
            </varlistentry>
            <varlistentry>
              <term><literal>separate</literal></term>
              <listitem><para>
                  Запускает ВМ с отделяемым интерфейсом пользователя,
                  что означает что ВМ запущена в фоновом режиме с
                  интерфейсом пользователя в отдельном процессе.
                </para><para>
                  Это экспериментальная функция, у которой отсутствует
                  некоторый функционал, например ускорение 3D.
                </para></listitem>
            </varlistentry>
          </variablelist></listitem>
      </varlistentry>
    </variablelist>
    <note>
      <para>
        Если ВМ не удается запуститься с определенным фронтендом и
        информация об ошибке неубедительна, рассмотрите запуск ВМ
        напрямую, путем запуска фронтенда. Этот обходной путь может
        выдать дополнительную информацию об ошибке.
      </para>
    </note>
  </refsect1>

  <refsect1>
    <title>Примеры</title>
    <remark role="help-scope" condition="GLOBAL" />
    <para>
      Следующая команда запускает ВМ <literal>ol7u6</literal>:
    </para>
<screen>$ VBoxManage startvm ol7u6</screen>
    <para>
      Следующая команда запускает ВМ <literal>ol7u6-mininstall</literal>
      в фоновом режиме.
    </para>
<screen>$ VBoxManage startvm ol7u6-mininstall --type headless</screen>
  </refsect1>

  <refsect1>
    <title>Смотрите также</title>
    <para>
<!--<xref linkend="vboxmanage-vboxheadless" />-->
      <xref linkend="vboxheadless" />,
      <xref linkend="vboxmanage-setproperty" />,
      <xref linkend="vboxmanage-modifyvm" />.
    </para>
  </refsect1>
</refentry>