<?xml version="1.0" encoding="UTF-8"?>
<!--
    manpage, user manual, usage: VBoxManage controlvm
-->
<!--
    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-controlvm" lang="en">
  <refentryinfo>
    <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</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>&nbsp;<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>&nbsp;<replaceable>начальная-точка-y</replaceable>&nbsp;<replaceable>разрешение-x</replaceable>&nbsp;<replaceable>разрешение-y</replaceable>&nbsp;<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> &ndash; Приоритет процесса
            по умолчанию, определенный ОС.
          </para></listitem>
        <listitem><para>
            <literal>flat</literal> &ndash; Предполагает политику
            планирования, которая устанавливает для процесса
            приоритет по умолчанию, при этом, всем потокам процесса
            устанавливается один и тот же приоритет.
          </para></listitem>
        <listitem><para>
            <literal>low</literal> &ndash; Предполагает политику
            планирования, которая устанавливает приоритет процесса
            в основном ниже приоритета по умолчанию ОС хоста.
          </para></listitem>
        <listitem><para>
            <literal>normal</literal> &ndash; Предполагает политику
            планирования, которая честно разделяет ресурсы ЦПУ с
            другими процессами, имеющими приоритет по умолчанию
            ОС хоста.
          </para></listitem>
        <listitem><para>
            <literal>high</literal> &ndash; Предполагает политику
            планирования, которая устанавливает приоритет процесса
            выше приоритета по умолчанию ОС хоста. Эта политика
            может повлиять на другие процессы, заставляя их ожидать
            ресурса ЦПУ больше положенного времени, что может
            привести к непредсказуемому поведению.
          </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>
