diff options
Diffstat (limited to 'doc/manual/ru_RU/man_VBoxManage-controlvm.xml')
| -rw-r--r-- | doc/manual/ru_RU/man_VBoxManage-controlvm.xml | 2174 |
1 files changed, 2174 insertions, 0 deletions
diff --git a/doc/manual/ru_RU/man_VBoxManage-controlvm.xml b/doc/manual/ru_RU/man_VBoxManage-controlvm.xml new file mode 100644 index 00000000..c0b1d011 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-controlvm.xml @@ -0,0 +1,2174 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage controlvm +--> +<!-- + Copyright (C) 2006-2022 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-controlvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2022-08-22 19:43:14 +0200 (Mon, 22 Aug 2022) $</pubdate> + <title>VBoxManage controlvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-controlvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-controlvm</refname> + <refpurpose>изменение состояния и настроек работающей виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-controlvm-pause"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">pause</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-resume"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">resume</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-reset"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">reset</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-poweroff"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">poweroff</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-savestate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">savestate</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpipowerbutton"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">acpipowerbutton</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpisleepbutton"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">acpisleepbutton</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-reboot"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">reboot</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-shutdown"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">shutdown</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputscancode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputscancode</arg> + <arg choice="req"><replaceable>hex</replaceable></arg> + <arg rep="repeat"><replaceable>hex</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputstring"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputstring</arg> + <arg choice="req"><replaceable>строка</replaceable></arg> + <arg rep="repeat"><replaceable>строка</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputfile"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputfile</arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setlinkstate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setlinkstate<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nic"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nic<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">null</arg> + <arg choice="plain">nat</arg> + <arg choice="plain">bridged</arg> + <arg choice="plain">intnet</arg> + <arg choice="plain">hostonly</arg> + <arg choice="plain">generic</arg> + <arg choice="plain">natnetwork</arg> + </group> + <arg><replaceable>имя-устройства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictrace"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nictrace<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictracefile"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nictracefile<replaceable>N</replaceable></arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicproperty"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nicproperty<replaceable>N</replaceable></arg> + <arg choice="req"><replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicpromisc"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nicpromisc<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">deny</arg> + <arg choice="plain">allow-vms</arg> + <arg choice="plain">allow-all</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">natpf<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">[<replaceable>имя-правила</replaceable>]<arg choice="plain">,tcp</arg></arg> + <arg choice="plain">udp,<arg><replaceable>IP-хоста</replaceable></arg>, + <arg choice="plain"><replaceable>порт-хоста</replaceable>,</arg> + <arg><replaceable>IP-гостя</replaceable></arg>, + <arg choice="plain"><replaceable>порт-гостя</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf-delete"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">natpf<replaceable>N</replaceable> delete</arg> + + <arg choice="req"><replaceable>имя-правила</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-guestmemoryballoon"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">guestmemoryballoon</arg> + <arg choice="req"><replaceable>размер-balloon-памяти</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbattach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">usbattach</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + </group> + <arg>--capturefile=<replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbdetach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">usbdetach</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioin"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">audioin</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioout"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">audioout</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-clipboard-mode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">clipboard mode</arg> + <group choice="req"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-draganddrop"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">draganddrop</arg> + <group choice="req"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrde"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrde</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeport"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdeport</arg> + <arg choice="req"><replaceable>port</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeproperty"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdeproperty</arg> + <arg choice="req"><replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdevideochannelquality"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdevideochannelquality</arg> + <arg choice="req"><replaceable>процент</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setvideomodehint"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setvideomodehint</arg> + <arg choice="req"><replaceable>разрешение-x</replaceable></arg> + <arg choice="req"><replaceable>разрешение-y</replaceable></arg> + <arg choice="req"><replaceable>бит/пиксел</replaceable></arg> + <arg><arg><replaceable>дисплей</replaceable></arg><group> + <arg choice="plain">enabled:yes | no</arg> + <arg><replaceable>начальная-точка-x</replaceable> <replaceable>начальная-точка-y</replaceable></arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setscreenlayout"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setscreenlayout</arg> + <arg choice="req"><replaceable>экран</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">primary <replaceable>начальная-точка-x</replaceable> <replaceable>начальная-точка-y</replaceable> <replaceable>разрешение-x</replaceable> <replaceable>разрешение-y</replaceable> <replaceable>бит/пиксел</replaceable></arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-screenshotpng"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">screenshotpng</arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + <arg><replaceable>display</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-screens"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording screens</arg> + <group choice="req"> + <arg choice="plain">all</arg> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>экран</replaceable>,[<replaceable>экран</replaceable>...]</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-filename"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording filename</arg> + <arg choice="req">filename</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videores"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videores</arg> + <arg choice="req"><replaceable>ширина</replaceable>x<replaceable>высота</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videorate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videorate</arg> + <arg choice="req"><replaceable>битрейт</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videofps"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videofps</arg> + <arg choice="req"><replaceable>кадров/сек</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxtime"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording maxtime</arg> + <arg choice="req"><replaceable>сек</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxfilesize"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording maxfilesize</arg> + <arg choice="req"><replaceable>МБ</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setcredentials"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setcredentials</arg> + <arg choice="req"><replaceable>имя-пользователя</replaceable></arg> + <arg choice="plain">--passwordfile=<group choice="req"> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + <arg choice="plain"><replaceable>пароль</replaceable></arg> + </group></arg> + <arg choice="req"><replaceable>имя-домена</replaceable></arg> + <arg choice="plain">--allowlocallogon=<group choice="req"> + <arg choice="plain">yes</arg> + <arg choice="plain">no</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-teleport"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">teleport</arg> + <arg choice="req">--host=<replaceable>имя-хоста</replaceable></arg> + <arg choice="req">--port=<replaceable>имя-порта</replaceable></arg> + <arg>--maxdowntime=<replaceable>мсек</replaceable></arg> + <group> + <arg choice="plain">--passwordfile=<replaceable>имя-файла</replaceable></arg> + <arg choice="plain">--password=<replaceable>пароль</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-plugcpu"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">plugcpu</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-unplugcpu"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">unplugcpu</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-cpuexecutioncap"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">cpuexecutioncap</arg> + <arg choice="req"><replaceable>число</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vm-process-priority"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vm-process-priority</arg> + <group choice="req"> + <arg choice="plain">default</arg> + <arg choice="plain">flat</arg> + <arg choice="plain">low</arg> + <arg choice="plain">normal</arg> + <arg choice="plain">high</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-attach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam attach</arg> + <arg><replaceable>путь</replaceable><arg><replaceable>настройки</replaceable></arg></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-detach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam detach</arg> + <arg><replaceable>путь</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-list"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam list</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-addencpassword"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">addencpassword</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + <group choice="req"> + <arg choice="plain"><replaceable>файл-с-паролем</replaceable></arg> + <arg choice="plain">-</arg> + </group> + <arg>--removeonsuspend=<group choice="plain"> + <arg choice="plain">yes</arg> + <arg choice="plain">no</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeencpassword"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">removeencpassword</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeallencpasswords"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">removeallencpasswords</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-changeuartmode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">changeuartmode<replaceable>N</replaceable></arg> + <group choice="plain"> + <arg choice="plain">disconnected</arg> + <arg choice="plain">server <replaceable>имя-канала</replaceable></arg> + <arg choice="plain">client <replaceable>имя-канала</replaceable></arg> + <arg choice="plain">tcpserver <replaceable>порт</replaceable></arg> + <arg choice="plain">tcpclient <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable></arg> + <arg choice="plain">file <replaceable>имя-файла</replaceable></arg> + <arg choice="plain"><replaceable>имя-устройства</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-autostart-enabled"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">autostart-enabled<replaceable>N</replaceable></arg> + <group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-autostart-delay"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">autostart-delay<replaceable>секунд</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage controlvm</command> позволяет изменить + состояние работающей виртуальной машины (ВМ). Следующие секции + описывают подкоманды, которые можно использовать: + </para> + <refsect2 id="vboxmanage-controlvm-pause"> + <title>Приостановить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> pause</command> временно + приостанавливает выполнение ВМ. Когда ВМ приостановлена, ее + состояние не изменяется постоянно. + </para> + <para> + Окно ВМ становится серым и заголовок окна показывает, что ВМ + приостановлена на текущий момент. Это действие эквивалентно + выбору <emphasis role="bold">Приостановить</emphasis> из + меню <emphasis role="bold">Машина</emphasis> графического + интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-resume"> + <title>Возобновить выполнение приостановленной виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> resume</command> перезапускает + выполнение приостановленной ВМ. Это действие эквивалентно выбору + <emphasis role="bold">Возобновить</emphasis> из меню + <emphasis role="bold">Машина</emphasis> графического интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-reset"> + <title>Сбросить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> reset</command> производит + холодный сброс ВМ. У этой команды тот же эффект, как и нажатие + кнопки "сброс" у физического компьютера. + </para> + <para> + Холодная перезагрузка немедленно перезапускает и перезагружает + гостевую операционную системы (ОС). Состояние ВМ перед сбросом + не сохраняется, поэтому можно потерять данные. Это действие + эквивалентно выбору <emphasis role="bold">Сброс</emphasis> из + меню <emphasis role="bold">Машина</emphasis> графического + интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-poweroff"> + <title>Выключить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> poweroff</command> выключает + ВМ. У этой команды тот же эффект как и вытаскивание кабеля питания + из физического компьютера. + </para> + <para> + Состояние ВМ перед выключением не сохраняется, поэтому можно + потерять данные. Это действие эквивалентно выбору + <emphasis role="bold">Закрыть</emphasis> из меню + <emphasis role="bold">Машина</emphasis> графического интерфейса + или нажатию на кнопку "Закрыть" окна ВМ и затем выбору + <emphasis role="bold">Выключить машину</emphasis>. + </para> + <para> + Когда ВМ в состоянии "выключено", ее можно перезапустить. + Смотрите <xref linkend="vboxmanage-startvm" />. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-savestate"> + <title>Сохранить состояние виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> savestate</command> сохраняет + текущее состояние ВМ на диск и затем останавливает ВМ. + </para> + <para> + Действие эквивалентно выбору <emphasis role="bold">Закрыть</emphasis> + из меню <emphasis role="bold">Машина</emphasis> графического интерфейса + или нажатию на кнопку "Закрыть" окна ВМ и затем выбору + <emphasis role="bold">Сохранить состояние машины</emphasis>. + </para> + <para> + Когда ВМ в состоянии "выключено", ее можно перезапустить. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-acpipowerbutton"> + <title>Отправить ACPI сигнал выключения в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> acpipowerbutton</command> отправляет + ACPI сигнал выключения в ВМ. У этой команды тот же эффект как + и нажатие кнопки "Включить" на физическом компьютере. + </para> + <para> + Пока в ВМ работает гостевая ОС, обеспечивающая поддержку ACPI, + эта команда запускает правильный механизм остановки внутри ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-acpisleepbutton"> + <title>Отправить ACPI сигнал перехода в спящий режим в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> acpisleepbutton</command> отправляет + ACPI сигнал перехода в спящий режим в ВМ. + </para> + <para> + Пока в ВМ работает гостевая ОС, обеспечивающая поддержку ACPI, + эта команда запускает правильный механизм перехода в спящий + режим внутри ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-reboot"> + <title>Перезагрузить гостевую ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> reboot</command> просит + гостевую ОС перезагрузиться. + </para> + <para> + Эта команда работает только если установлена + последняя версия Дополнений Гостевой ОС. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-shutdown"> + <title>Выключить гостевую ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> shutdown</command> + просит гостевую ОС выключиться + </para> + <para> + Эта команда работает только если установлена + последняя версия Дополнений Гостевой ОС. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputscancode"> + <title>Отправить клавиатурные сканкоды в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputscancode</command> + отправляет команды клавиатурных сканкодов в ВМ. + </para> + <para> + По информации о клавиатурных сканкодах смотрите + <ulink url="http://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html" />. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputstring"> + <title>Отправить клавиатурные строки в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputstring</command> + отправляет клавиатурные строки в ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputfile"> + <title>Отправить файл в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputfile</command> + отправляет файл в ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-teleport"> + <title>Настроить цель для портирования виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> teleport</command> инициирует + операцию портирования между указанной ВМ и указанной системой + хоста. Смотрите <xref linkend="teleporting" />. + </para> + <para> + Если вы указываете пароль, он должен соответствовать паролю, + используемому при вызове команды <command>VBoxManage + modifyvm</command> для целевой машины. + </para> + <variablelist> + <varlistentry> + <term><option>--host=<replaceable>имя-хоста</replaceable></option></term> + <listitem><para> + Указывает имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port=<replaceable>порт</replaceable></option></term> + <listitem><para> + Указывает порт, который ВМ должна прослушивать для получения + запросов на портирование с других ВМ. Номер порта может быть + любой свободный TCP/IP порт, например <literal>6000</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--maxdowntime=<replaceable>мсек</replaceable></option></term> + <listitem><para> + Задает максимальное время простоя в миллисекундах для портируемой + целевой виртуальной машины. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--password=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Указывает пароль, используемый исходной машиной для запроса + на портирование. Запрос удовлетворяется только если + исходная машины указывает тот же самый пароль. + </para><remark> + Такой дизайн не соответствует рекомендациям Oracle по безопасности. + Вы не должны указывать пароль в командной строке, потому что + его можно увидеть в списке процессов. + </remark><para> + Опция <option>--password</option> является взаимоисключающей с опцией + <option>--passwordfile</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--passwordfile=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Указывает файл откуда берется пароль, испольуемый исходной + машиной для запроса на портирование. Запрос удовлетворяется + только если исходная машина указывает тот же самый пароль. + </para><para> + Если указатть в качестве имени файла <literal>stdin</literal>, + можно читать пароль со стандартного потока ввода. + </para><para> + Опция <option>--passwordfile</option> является взаимоисключающей + с опцией <option>--password</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setlinkstate"> + <title>Установить состояние сетевого подключения для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + setlinkstate<replaceable>N</replaceable></command> позволяет подключить + или отключить виртуальный сетевой кабель от экземпляра сетевого + интерфейса(<replaceable>N</replaceable>). Допустимые значения: + <literal>on</literal> и <literal>off</literal>. Значение по умолчанию + <literal>on</literal>. + </para> + <para> + Перед подключением виртуального сетевого кабеля используйте команду + <command>VBoxManage controlvm nictracefile<replaceable>N</replaceable> + </command> во время работы ВМ для задания имени файла для записи + журнала. Или используйте команду <command>VBoxManage modifyvm + --nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></command> + для этих же целей, если ВМ не работает. + </para> + <para> + Эта подкоманда не влияет прямо на состояние работы ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nic"> + <title>Задать тип сети, используемой виртуальной машиной</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nic<replaceable>N</replaceable></command> указывает тип сети + в указаной сетевой карте ВМ. + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. + </para> + <para> + Следующие допустимые типы сети также описаны в + <xref linkend="networkingmodes" />: + </para> + <itemizedlist> + <listitem><para> + <literal>null</literal> указывает, что ВМ не подключена к + хост-системе. + </para></listitem> + <listitem><para> + <literal>nat</literal> указывает, что ВМ использует сетевое + преобразование адресов (NAT). + </para></listitem> + <listitem><para> + <literal>bridged</literal> указывает, что ВМ использует + сетевой мост. + </para></listitem> + <listitem><para> + <literal>intnet</literal> указывает, что ВМ обменивается + с другими ВМ, используя внутреннюю сеть. + </para></listitem> + <listitem><para> + <literal>hostonly</literal> указывает, что ВМ использует + сеть хоста. + </para></listitem> + <listitem><para> + <literal>natnetwork</literal> указывает, что ВМ испльзует + сеть NAT. + </para></listitem> + <listitem><para> + <literal>generic</literal> указывает, что у ВМ есть доступ + у редко используемым под-режимами. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nictrace"> + <title>Отследить сетевой траффик виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictrace<replaceable>N</replaceable></command> позволяет + отслеживать сетевой траффик на указанной виртуальной сетевой + карте (<replaceable>N</replaceable>). + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. Допустимые значения: <literal>on</literal> и + <literal>off</literal>. Значение по умолчанию + <literal>off</literal>. + </para> + <para> + Когда устанавливается в <literal>on</literal>, необходимо + использовать то же самое значение <replaceable>N</replaceable> + для команды <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictracefile<replaceable>N</replaceable></command>, что было + использовано для указания пути и имени файла журнала, в который + производится запись результатов отслеживания. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nictracefile"> + <title>Задать файл журнала для отслеживания сетевого траффика виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictracefile<replaceable>N</replaceable></command> позволяет вам + задать имя файла журнала для отслеживания сетевого траффика для + указанной виртуальной сетевой карты (<replaceable>N</replaceable>). + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. Убедитесь, что задано то же значение + <replaceable>N</replaceable>, какое использовано для команд + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nic<replaceable>N</replaceable></command> и + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictrace<replaceable>N</replaceable></command>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nicpromisc"> + <title>Указать используемый неразборчивый режим для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nicpromisc<replaceable>N</replaceable></command> позволяет указать + как обрабатывать неразборчивый режим для сетевого моста. Значение + по умолчанию <literal>deny</literal> скрывает весь траффик, не + предназначенный для этой ВМ. Значение <literal>allow-vms</literal> + скрывает весь траффик хоста от этой ВМ, но позволяет ВМ просматривать + траффик с других ВМ. Значение <literal>allow-all</literal> убирает + это ограничение полностью. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nicproperty"> + <title>Задать значение свойства сетевого бэкенда виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nicproperty<replaceable>N</replaceable> + <replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></command> + в комбинации с <literal>nicgenericdrv</literal> позволяет передать + значения свойств в редко используемые сетевые бэкенды. + </para> + <para> + Эти свойства специфичны для бэкенда и различны между драйверами + UDP туннеля и VDE бэкенда. Смотрите <xref linkend="network_udp_tunnel" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-natpf"> + <title>Задать правило для перенаправления портов NAT для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + natpf<replaceable>N</replaceable></command> задает правило перенаправления + портов NAT. Смотрите <xref linkend="natforward"/>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-natpf-delete"> + <title>Удалить правило для перенаправления портов NAT для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда<command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + natpf<replaceable>N</replaceable> delete</command> удаляет указанное + правило перенаправления портов NAT. Смотрите <xref linkend="natforward"/>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-guestmemoryballoon"> + <title>Изменить размер гостевого memory balloon виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> guestmemoryballoon</command> + изменяет размер гостевого memory balloon. Гостевой memory balloon - + это память выделенная Дополнениями Гостевой ОС &product-name; у + гостевой системы и возвращенная гипервизору для использования + другими ВМ. Значение указывается в мегабайтах. Смотрите + <xref linkend="guestadd-balloon" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-usbattach"> + <title>Сделать USB устройство хост-системы видимым для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> usbattach</command> динамически + подключает USB устройство хоста к ВМ, что делает его видимым. + Не нужно создавать фильтр. + </para> + <para> + Можно указывать USB устройство через Универсальный Уникальный + Идентификатор (UUID) или через адрес в хост-системе. используйте + команду <command>VBoxManage list usbhost</command> для получения + информации об USB устройствах хост-системы. + </para> + <para> + Используйте опцию <option>--capturefile</option> для задания + абсолютного пути к файлу для записи данных журналирования. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-usbdetach"> + <title>Сделать USB устройство хост-системы невидимым для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> usbdetach</command> динамически + отключает USB устройство хоста от ВМ, что делает его невидимым. + Не нужно создавать фильтр. + </para> + <para> + Можно указывать USB устройство через Универсальный Уникальный + Идентификатор (UUID) или через адрес в хост-системе. используйте + команду <command>VBoxManage list usbhost</command> для получения + информации об USB устройствах хост-системы. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-audioin"> + <title>Включить или выключить аудио захват из хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> audioin</command> указывает + включить или выключить аудио захват из хост-системы. Допустимые + значения: <literal>on</literal>, которая включает аудио захват и + <literal>off</literal>, которая выключает аудио захват. Значение + по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-audioout"> + <title>Включить или выключить аудио воспроизведение из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> audioout</command> указывает + включить или выключить аудио воспроизведение из гостевой ВМ. + Допустимые значения: <literal>on</literal>, которая включает + аудио воспроизведение и <literal>off</literal>, которая выключает + аудио воспроизведение. Значение по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-clipboard-mode"> + <title>Задать как предоставить общий доступ к буферам обмена хост ОС или гостевой ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> clipboard mode</command> задает + как предоставить общий доступ к буферам обмена гостевой системы + или хоста хост-системе или ВМ. Допустимые значения: + <literal>disabled</literal>, <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и <literal>bidirectional</literal>. + Значение по умолчанию <literal>disabled</literal>. Смотрите + <xref linkend="generalsettings" />. + </para> + <para> + Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, + установленных в ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-draganddrop"> + <title>Задать режим Drag and Drop между хост-системой и виртуальной машиной</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> draganddrop</command> Задает + текущий режим drag and drop, используемый между хост-системой + и ВМ. Допустимые значения: <literal>disabled</literal>, + <literal>hosttoguest</literal>, <literal>guesttohost</literal> + и <literal>bidirectional</literal>. Значение по умолчанию + <literal>disabled</literal>. Смотрите <xref linkend="guestadd-dnd" />. + </para> + <para> + Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, + установленных в ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrde"> + <title>Включить или выключить VRDE сервер</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrde</command> включает или + выключает сервер Расширения Удаленного Рабочего Стола VirtualBox (VRDE), + если он установлен. Допустимые значения: <literal>on</literal> и + <literal>off</literal>. Значение по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdeport"> + <title>Задать порты VRDE сервера</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrdeport</command> задает + порт или диапазон портов к которым VRDE сервер может подключиться. + Значение по умолчанию <literal>default</literal> или + <literal>0</literal>, который обозначает стандартный RDP порт + <literal>3389</literal>. + </para> + <para> + Также смотрите описание опции <option>--vrde-port</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdeproperty"> + <title>Задать номера портов и IP адреса VRDE сервера</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrdeproperty</command> указывает + номера портов и IP адрес в ВМ, к которым может подключиться VRDE + сервер. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <literal>TCP/Ports</literal> задает порт или диапазон портов + на которые может подключиться VRDE сервер. Значение по + умолчанию <literal>default</literal> или <literal>0</literal>, + который означает стандартный RDP порт <literal>3389</literal>. + </para><para> + Также смотрите описание опции <option>--vrde-port</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para></listitem> + <listitem><para> + <literal>TCP/Address</literal> указывает IP адрес сетевого + интерфейса хоста, к которому может подключиться VRDE сервер. + Если указан, сервер принимает подключения только к указанному + сетевому интерфейсу хоста. + </para><para> + Также смотрите описание опции <option>--vrde-address</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/Enabled</literal> позволяет подключить + видеоканал Протокола Удаленного Рабочего Стола (VRDP). + Допустимые значения <literal>1</literal> для включения + видеоканала и <literal>0</literal> для выключения. Значение + по умолчанию <literal>0</literal>. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/Quality</literal> указывает уровень + сжатия JPEG в видеоканале сервера VRDE. Допустимые значения + между 10% и 100% включительно. Меньшие значения подразумевают + худшее качество, но более высокое сжатие. Значение по умолчанию + <literal>100</literal>. Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/DownscaleProtection</literal> позволяет + подключить функцию защиты от уменьшения масштаба видеоканала. + Укажите <literal>1</literal> для включения. По умолчанию + выключено. + </para><para> + Когда функция включена, если размер видео равен размеру теневого + буфера, видео отображается в полноэкранном режиме. Если размер + видео между полным экраном и порогом уменьшения масштаба, видео + не отображается, так как это может быть окно приложения, которое + может быть нечитаемым в случае уменьшения масштаба. Когда функция + отключена, функция защиты от уменьшения масштаба всегда пытается + отобразить видео. + </para></listitem> + <listitem><para> + <literal>Client/DisableDisplay</literal> позволяет отключить функцию + отображения сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию null. Смотрите + <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableInput</literal> позволяет отключить функцию + ввода сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableAudio</literal> позволяет отключить функцию + аудио сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableUSB</literal> позволяет отключить функцию + USB сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableClipboard</literal> позволяет отключить + функцию буфера обмена сервера VRDE. Допустимые значения + <literal>1</literal>, отключающее функцию и null + (<literal>""</literal>), включающую эту функцию. + Используйте <literal>Client/DisableClipboard=</literal> для + включения этой функции. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableUpstreamAudio</literal> позволяет отключить + функцию загрузки аудио на сервер VRDE. Допустимые значения + <literal>1</literal>, отключающее функцию и null + (<literal>""</literal>), включающую эту функцию. + Используйте <literal>Client/DisableUpstreamAudio=</literal> для + включения этой функции. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableRDPDR</literal> позволяет отключить функцию + Перенаправления Устройств RDP Для Смарт-Карт сервера VRDE. + Допустимые значения <literal>1</literal>, отключающее функцию и + null (<literal>""</literal>), включающую эту функцию. + Значение по умолчанию <literal>1</literal>. Смотрите + <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>H3DRedirect/Enabled</literal> позволяет включить функцию + Перенаправления 3D сервера VRDE. Допустимые значения + <literal>1</literal>, включающее функцию и + null (<literal>""</literal>), отключающую эту функцию. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Security/Method</literal> указывает метод безопасности, + используемый для подключения. Смотрите <xref linkend="vrde-crypt" />. + </para><itemizedlist> + <listitem><para> + <literal>Negotiate</literal> принимает RDP подключения, имеющие + и повышенный (TLS) и стандартный протокол безопасности. Метод + безопасности оговаривается с клиентом. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>RDP</literal> принимает только RDP подключения со + стандартным протоколом безопасности. + </para></listitem> + <listitem><para> + <literal>TLS</literal> принимает только RDP подключения с + повышенным протоколом безопасности. Клиент должен поддерживать + TLS. + </para></listitem> + </itemizedlist></listitem> + <listitem><para> + <literal>Security/ServerCertificate</literal> указывает абсолютный + путь к сертификату сервера, используемому в подключении. + Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Security/ServerPrivateKey</literal> указывает абсолютный + путь к приватному ключу сервера. Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Security/CACertificate</literal> указывает абсолютный + путь к корневому самоподписанному сертификату. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Audio/RateCorrectionMode</literal> указывает используемый + режим коррекции битрейта. + </para><itemizedlist> + <listitem><para> + <literal>VRDP_AUDIO_MODE_VOID</literal> отображает что + режим коррекции не используется. Используйте это значение + для снятия ранее установленного режима. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_RC</literal> указывает, что надо + использовать режим коррекции скорости. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_LPF</literal> указывает, что надо + использовать режим НЧ фильтра. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_CS</literal> указывает, что надо + использовать режим синхронизации клиента для предотвращения + незаполненности или переполнения очереди клиента. + </para></listitem> + </itemizedlist></listitem> + <listitem><para> + <literal>Audio/LogPath</literal> указывает абсолютный путь к файлу + журнала аудио. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdevideochannelquality"> + <title>Указать качество изображения для перенаправления видео VRDP</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + vrdevideochannelquality</command> задает качество изображения как + значение уровня сжатия JPEG для перенаправления видео. Допустимые + значения между 10% и 100% включительно. Меньшие значения подразумевают + худшее качество, но более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setvideomodehint"> + <title>Указать режим видео для гостевой ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> setvideomodehint</command> + задает используемый режим видео для гостевой ВМ. У вас должны + быть установлены Дополнения Гостевой ОС. Заметим, что данная + функция работает не для всех гостевых систем. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setscreenlayout"> + <title>Задать макет экрана для монитора в гостевой ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> setscreenlayout</command> + может быть использована для настройки ВМ с несколькими мониторами. + Указанный экран гостевой ВМ может быть включен или отключен + или может быть настроен пользовательский макет экрана. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-screenshotpng"> + <title>Сделать снимок экрана с монитора виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> screenshotpng</command> делает + снимок экрана с монитора гостевой системы и сохраняет его в + формате PNG в указанном файле. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <replaceable>имя-файла</replaceable> задает имя создаваемого + PNG файла. + </para></listitem> + <listitem><para> + <replaceable>монитор</replaceable> задает номер монитора + откуда сделать снимок. Для ВМ с единственным монитором это + значение <literal>0</literal>. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording"> + <title>Включить или выключить запись сессии виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording</command> включает + или выключает запись сессии ВМ в WebM/VP8 файл. Допустимые значения + <literal>on</literal>, которое начинает запись, когда стартует + сессия ВМ и <literal>off</literal>, отключающее запись. Значение + по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-screens"> + <title>Задать экран виртуальной машины для записи</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording screens</command> + позволяет задать экран ВМ для записи. Запись для каждого + указанного вами экрана сохраняется в отдельный файл в папке + машины. Нельзя изменять эту настройку пока запись включена. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <literal>all</literal> указывает, что записывать все экраны ВМ. + </para></listitem> + <listitem><para> + <literal>none</literal> указывает, что не надо записывать экраны. + </para></listitem> + <listitem><para> + <replaceable>ID-экрана</replaceable> задает один или больше экранов + ВМ для записи. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-filename"> + <title>Задать файл для сохранения записанной сессии виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording filename</command> + задает файл для сохранения записанной сессии. Нельзя изменять + эту настройку пока запись включена. + </para> + <para> + По умолчанию запись сохраняется в файл, находящийся в папке машины, + с именем ВМ в качестве имени файла и расширением + <filename>webm</filename>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videores"> + <title>Задать разрешение записанного видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + recording videores</command> задает разрешение записанного видео в + пикселах. Нельзя изменять эту настройку пока включена запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек записи видео, + основанных на разрешении (размере кадра). Смотрите поле Размер Кадра + во вкладке Запись страницы Монитор для просмотра значения по умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <para> + Разрешение задается в виде + <replaceable>ширина</replaceable><literal>x</literal><replaceable>высота</replaceable>: + </para> + <itemizedlist> + <listitem><para> + <replaceable>ширина</replaceable> задает ширину в пикселах. + </para></listitem> + <listitem><para> + <replaceable>высота</replaceable> задает высоту в пикселах. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videorate"> + <title>Задать битрейт видео</title> + <remark role="help-copy-synopsis"/> +<!-- @todo r=andy Clarify rate. --> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording videorate</command> + задает битрейт видео в килобит в секунду. Увеличение этого + значения улучшает качество видео за счет увеличения размера + файла. Нельзя изменять это значение пока включена запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек + записи видео, основанных на размере кадра. Смотрите поле + Качество Видео вкладки Запись страницы Монитор для просмотра + значения по умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videofps"> + <title>Задать максимальную частоту видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording videofps</command> + задает максимальную частоту видео для записи. Частота видео + измеряется в кадрах в секунду (FPS). Запись пропускает кадры, + имеющие частоту выше, чем указанный максимум. Увеличение + частоты уменьшает количество пропущенных кадров и увеличивает + размер файла. Нельзя изменять эту настройку пока включена + запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек записи + видео, основанных на размере кадра. Смотрите поле Частота Кадров во + вкладке Запись страницы Монитор для просмотра значения по + умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-maxtime"> + <title>Задать максимальное время записи видео</title> + <remark role="help-copy-synopsis"/> +<!-- @todo r=andy Clarify time format. --> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording maxtime</command> + задает максимальное время записи в секундах. Запись + останавливается по прошествии заданного количества секунд. + Если это значение равно нулю, запись продолжается пока + не будет остановлена принудительно. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-maxfilesize"> + <title>Задать максимальный размер записанного видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording maxfilesize</command> + задает максимальный размер записанного видео в мегабайтах. + Запись останавливается когда файл достигает заданного размера. + Если это значение равно нулю, запись продолжается пока не будет + остановлена принудительно. Нельзя изменять эту настройку пока + включена запись. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setcredentials"> + <title>Задать учетные данные для удаленного входа в виртуальные машины Windows</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>setcredentials</command> позволяет задать + учетные данные для удаленного входа в Windows ВМ. + Смотрите <xref linkend="autologon" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <replaceable>имя-пользователя</replaceable> задает имя + пользователя под которым необходимо производить вход + в Windows ВМ. + </para></listitem> + <listitem><para> + Опция + <option>--passwordfile=<replaceable>имя-файла</replaceable></option> + задает файл откуда брать пароль для + <replaceable>имя-пользователя</replaceable>. + </para><para> + Опция <option>--passwordfile</option> взаимоисключающая с опцией + <option>--password</option>. + </para></listitem> + <listitem><para> + Опция + <option>--password=<replaceable>пароль</replaceable></option> + задает пароль для <replaceable>имя-пользователя</replaceable>. + </para><remark> + Такой дизайн не соответствует рекомендациям Oracle по + безопасности. Вы не должны указывать пароль в командной + строке, потому что он может быть виден в списке процессов. + </remark><para> + Опция <option>--password</option> взаимоисключающая с опцией + <option>--passwordfile</option>. + </para></listitem> + <listitem><para> + Опция <option>--allowlocallogin</option> позволяет включать или + отключать локальные входы. Допустимые значения + <literal>on</literal> для включения локальных входов и + <literal>off</literal> для отключения. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-plugcpu"> + <title>Добавить виртуальный ЦПУ в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> plugcpu</command> добавляет + виртуальный ЦПУ в указанную ВМ если горячее подключение ЦПУ + включено. <replaceable>ID</replaceable> задает индекс + добавляемого виртуального ЦПУ и он должен быть в диапазоне + от 0 до максимального количества настроенных ЦПУ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-unplugcpu"> + <title>Удалить виртуальный ЦПУ из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> unplugcpu</command> удаляет + виртуальный ЦПУ из указанной ВМ если горячее подключение ЦПУ + включено. <replaceable>ID</replaceable> задает индекс + удаляемого виртуального ЦПУ и он должен быть в диапазоне + от 0 до максимального количества настроенных ЦПУ. Нельзя + удалить ЦПУ 0. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-cpuexecutioncap"> + <title>Установить максимальное время физического ЦПУ, используемого виртуальным ЦПУ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> cpuexecutioncap</command> + задает максимальное количество времени физического ЦПУ + используемого виртуальным ЦПУ. Допустимые значения - это + процент между <literal>1</literal> и <literal>100</literal>. + Значение <literal>50</literal> указывает, что единственный + виртуальный ЦПУ может использовать до 50% физического ЦПУ. + По умолчанию установлено <literal>100</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vm-process-priority"> + <title>Изменить приоритет процесса ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vm-process-priority</command> + задает схему приоритета процесса ВМ используемую при старте + и работе ВМ. + </para> + <para> + Допустимые значения: + </para> + <itemizedlist> + <listitem><para> + <literal>default</literal> – Приоритет процесса + по умолчанию, определенный ОС. + </para></listitem> + <listitem><para> + <literal>flat</literal> – Предполагает политику + планирования, которая устанавливает для процесса + приоритет по умолчанию, при этом, всем потокам процесса + устанавливается один и тот же приоритет. + </para></listitem> + <listitem><para> + <literal>low</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + в основном ниже приоритета по умолчанию ОС хоста. + </para></listitem> + <listitem><para> + <literal>normal</literal> – Предполагает политику + планирования, которая честно разделяет ресурсы ЦПУ с + другими процессами, имеющими приоритет по умолчанию + ОС хоста. + </para></listitem> + <listitem><para> + <literal>high</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + выше приоритета по умолчанию ОС хоста. Эта политика + может повлиять на другие процессы, заставляя их ожидать + ресурса ЦПУ больше положенного времени, что может + привести к непредсказуемому поведению. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-attach"> + <title>Подключить вебкамеру к виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam attach</command> + подключает вебкамеру к работающей ВМ. Задайте вебкамеру + через абсолютный путь к камере в ОС хоста или через псевдоним. + Используйте команду <command>VBoxManage list webcams</command> + для получения псевдонимов вебкамер. + </para> + <para> + Обратите внимание, что псевдоним <literal>.0</literal> - это + устройство получения видео по умолчанию в ОС хоста. + <literal>.1</literal> - это первое устройство получения видео, + <literal>.2</literal> - второе, и т.д. Порядок устройств + зависит от системы хоста. + </para> + <para> + Можно указать необязательные настройки в виде пар имя-значение + разделенных точкой с запятой (<literal>;</literal>). Эти + свойства позволяют настроить устройство эмулируемой вебкамеры. + </para> + <para> + Поддерживаются следующие настройки: + </para> + <variablelist> + <varlistentry> + <term><literal>MaxFramerate</literal></term> + <listitem><para> + Задает максимальную частоту кадров с которой видео отправляется + в ВМ. Задается в кадрах в секунду. Более высокие значения + увеличивают нагрузку на ЦПУ, так что этот параметр можно + использовать для уменьшения нагрузки на ЦПУ. Значение + по умолчанию - <literal>no maximum limit</literal>. Это значение + позволяет ВМ использовать любую частоту кадров, поддерживаемую + вебкамерой. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>MaxPayloadTransferSize</literal></term> + <listitem><para> + Задает максимальное количество байтов, принимаемого ВМ из + эмулируемой камеры в одном буфере. Значение по умолчанию - + <literal>3060</literal> байт, используемое некоторыми + вебкамерами. Если ВМ способна использовать буферы большего + размера, это может немного уменьшить нагрузку на ЦПУ. + Заметим, что некоторые гостевые ОС могу не поддерживать + более высокие значения <literal>MaxPayloadTransferSize</literal>. + </para></listitem> + </varlistentry> + </variablelist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-detach"> + <title>Отключить вебкамеру от виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam detach</command> + отключает вебкамеру от работающей ВМ. Задайте вебкамеру + через абсолютный путь к камере в ОС хоста или через псевдоним. + Используйте команду <command>VBoxManage list webcams</command> + для получения псевдонимов вебкамер. + </para> + <para> + Когда вебкамера отключается от хоста, ОС хоста определяет поведение + эмулируемой вебкамеры. + </para> + <itemizedlist> + <listitem><para> + <emphasis role="bold">Хосты Windows:</emphasis> Устройство + эмулируемой вебкамеры отключается от ВМ автоматически. + </para></listitem> + <listitem><para> + <emphasis role="bold">Хосты Mac OS X, которые работают + по крайней мере под OS X 10.7:</emphasis> Устройство + эмулируемой вебкамеры остается подключенным к ВМ. Его + необходимо отключить вручную, используя команду + <command>VBoxManage controlvm webcam detach</command>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Хосты Linux:</emphasis> Устройство + эмулируемой вебкамеры отключается от ВМ автоматически + только если вебкамера активно транслирует видео. Если + эмулируемая камера не активна, необходимо отключить ее + вручную, используя команду <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam detach</command>. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-list"> + <title>Отобразить вебкамеры, подключенные к виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam list</command> показывает + вебкамеры, подключенные к работающей ВМ. Вывод отображает список + абсолютных путей или псевдонимов подключенных к ВМ вебкамер, + используя команду <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam attach</command>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-addencpassword"> + <title>Передать пароль шифрования в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> addencpassword</command> + обеспечивает шифрованную ВМ <replaceable>имя-ВМ</replaceable> + паролем шифрования для возможности старта в фоновом режиме. + Укажите абсолютный путь к файлу с паролем в хост-системе. + Если вместо <replaceable>имя-файла</replaceable> указан + <literal>-</literal>, <command>VBoxManage</command> предложит + ввести пароль. + </para> + <para> + Используйте опцию <option>--removeonsuspend</option> для указания + что пароль должен быть удален из памяти ВМ или сохранен когда + ВМ приостановлена. + </para> + <para> + Если ВМ приостановлена и пароль очищен используйте + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + addencpassword</command>, чтобы указать пароль для продолжения + выполнения ВМ. Используйте эту функцию если не хотите оставлять + пароль в памяти ВМ пока ВМ приостановлена событием приостановки + хоста. + </para> + <note> + <para> + Можно шифровать данные, хранящиеся в образах жестких дисков, + испольуемых ВМ. &product-name; использует алгоритм AES в режиме + XTS и поддерживает 128 и 256 битные ключи шифрования данных + (DEK). Зашифрованный DEK хранится в свойствах носителя и + расшифровывается при старте ВМ когда вы передаете пароль + шифрования. + </para> + </note> + <para> + Используйте команду <command>VBoxManage encryptmedium</command> + для создания носителя зашифрованного DEK. Смотрите + <xref linkend="diskencryption-encryption" />. + </para> + <para> + Графический интерфейс &product-name; предложит ввести пароль + шифрования при старте зашифрованной ВМ. + </para> + <para> + Используйте следующую команду для старта в фоновом режиме + зашифрованной ВМ: + </para> +<screen> + $ VBoxManage startvm <replaceable>имя-ВМ</replaceable> --type headless + </screen> + <para> + Затем, используйте следующую команду для передачи пароля + шифрования: + </para> +<screen> + $ VBoxManage <replaceable>имя-ВМ</replaceable> controlvm addencpassword <replaceable>имя-ВМ</replaceable> - + Пароль: <replaceable>пароль-шифрования</replaceable> + </screen> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-removeencpassword"> + <title>Отозвать пароль шифрования из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> removeencpassword</command> + отзывает указанный пароль шифрования для всех зашифрованных + носителей, подключенных к ВМ. + </para> + <para> + <replaceable>ID</replaceable> - идентификатор пароля, который + вы хотите отозвать. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-removeallencpasswords"> + <title>Отозвать все пароли шифрования из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + removeallencpasswords</command> отзывает все пароли шифрования + для всех зашифрованных носителей подключенных к ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-changeuartmode"> + <title>Изменить режим подключения виртуального последовательного порта в виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> changeuartmode</command> + изменяет режим подключения для указанного виртуального + последовательного порта. Допустимые значения последовательного + порта - это числа, начинающиеся с <literal>1</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <variablelist> + <varlistentry> + <term>disconnected</term> + <listitem><para> + Отключает устройство. + </para></listitem> + </varlistentry> + <varlistentry> + <term>server <replaceable>имя-канала</replaceable></term> + <listitem><para> + Указывает имя канала сервера. + </para></listitem> + </varlistentry> + <varlistentry> + <term>client <replaceable>имя-канала</replaceable></term> + <listitem><para> + Указывает имя канала клиента. + </para></listitem> + </varlistentry> + <varlistentry> + <term>tcpserver <replaceable>порт</replaceable></term> + <listitem><para> + Указывает номер порта сервера TCP. + </para></listitem> + </varlistentry> + <varlistentry> + <term>tcpclient <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable></term> + <listitem><para> + Указывает имя хоста и номер порта клиента TCP. + </para></listitem> + </varlistentry> + <varlistentry> + <term>file <replaceable>имя-файла</replaceable></term> + <listitem><para> + Указывает имя файла. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-устройства</replaceable></term> + <listitem><para> + Указывает имя устройства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-autostart-enabled"> + <title>Включить автостарт ВМ во время загрузки хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> autostart-enabled</command> + указывает включить или отключить автоматический старт ВМ во + время загрузки хост-системы. Вы должны произвести некоторую + настройку хост-системы перед тем как вы сможете использовать + данный функционал. Смотрите <xref linkend="autostart" />. + Допустимые значения <literal>on</literal>, включающую + функцию автостарта для ВМ и <literal>off</literal>, + отключающую ее. Значение по умолчанию <literal>off</literal>. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-autostart-delay"> + <title>Установить задержку старта ВМ во время загрузки хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> autostart-delay</command> + задает задержку в секундах перед тем, как ВМ будет запущена + во время загрузки хост-системы. Смотрите + <xref linkend="autostart" />. + </para> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда временно останавливает выполнение ВМ + <filename>ol7</filename>. + </para> +<screen>$ VBoxManage controlvm ol7 pause</screen> + <para> + Следующая команда настраивает операции буфера обмена для ВМ + <filename>ol7</filename>. Копирование данных буфера обмена + разрешено в обоих направлениях между хостом и гостевой + системой. + </para> +<screen>$ VBoxManage controlvm ol7 clipboard mode bidirectional</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-modifyvm" />, + <xref linkend="vboxmanage-startvm" /> + </para> + </refsect1> +</refentry> |