diff options
Diffstat (limited to 'doc/manual/ru_RU/man_VBoxManage-modifyvm.xml')
| -rw-r--r-- | doc/manual/ru_RU/man_VBoxManage-modifyvm.xml | 2740 |
1 files changed, 2740 insertions, 0 deletions
diff --git a/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml new file mode 100644 index 00000000..3dad10f0 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml @@ -0,0 +1,2740 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage modifyvm +--> +<!-- + Copyright (C) 2006-2022 Oracle and/or its affiliates. + + This file is part of VirtualBox base platform packages, as + available from https://www.virtualbox.org. + + This program is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License + as published by the Free Software Foundation, in version 3 of the + License. + + This program is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, see <https://www.gnu.org/licenses>. + + SPDX-License-Identifier: GPL-3.0-only +--> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[ +<!ENTITY % all.entities SYSTEM "all-entities.ent"> +%all.entities; +]> +<refentry id="vboxmanage-modifyvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-09 19:05:30 +0100 (Mon, 09 Jan 2023) $</pubdate> + <title>VBoxManage modifyvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-modifyvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-modifyvm</refname> + <refpurpose>изменение настроек остановленной виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-general"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--name=<replaceable>имя</replaceable></arg> + <arg>--groups= <arg choice="plain"><replaceable>группа</replaceable> [,<replaceable>группа</replaceable>...]</arg></arg> + <arg>--description=<replaceable>описание</replaceable></arg> + <arg>--os-type=<replaceable>тип-ОС</replaceable></arg> + <arg>--icon-file=<replaceable>имя-файла</replaceable></arg> + <arg>--memory=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--page-fusion=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vram=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--acpi=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ioapic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hardware-uuid=<replaceable>UUID</replaceable></arg> + <arg>--cpus=<replaceable>число-ЦПУ</replaceable></arg> + <arg>--cpu-hotplug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--plug-cpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--unplug-cpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--cpu-execution-cap=<replaceable>число</replaceable></arg> + <arg>--pae=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--long-mode=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-exit=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--spec-ctrl=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--cpu-profile=<group choice="plain"> + <arg choice="plain">host</arg> + <arg choice="plain">Intel 8086</arg> + <arg choice="plain">Intel 80286</arg> + <arg choice="plain">Intel 80386</arg> + </group></arg> + <arg>--hpet=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hwvirtex=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--triple-fault-reset=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--x2apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--paravirt-provider=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">default</arg> + <arg choice="plain">legacy</arg> + <arg choice="plain">minimal</arg> + <arg choice="plain">hyperv</arg> + <arg choice="plain">kvm</arg> + </group></arg> + <arg>--paravirt-debug= <arg choice="plain"><replaceable>ключ</replaceable>=<replaceable>значение</replaceable> [,<replaceable>ключ</replaceable>=<replaceable>значение</replaceable>...]</arg></arg> + <arg>--nested-paging=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--large-pages=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtx-vpid=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtx-ux=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nested-hw-virt=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--virt-vmsave-vmload=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate-3d=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate-2d-video=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--chipset=<group choice="plain"> + <arg choice="plain">ich9</arg> + <arg choice="plain">piix3</arg> + </group></arg> + <arg>--iommu=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">automatic</arg> + <arg choice="plain">amd</arg> + <arg choice="plain">intel</arg> + </group></arg> + <arg>--tpm-type=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">1.2</arg> + <arg choice="plain">2.0</arg> + <arg choice="plain">host</arg> + <arg choice="plain">swtpm</arg> + </group></arg> + <arg>--tpm-location=<group choice="plain"> + <arg choice="plain"><replaceable>расположение</replaceable></arg> + </group></arg> + <arg>--bios-logo-fade-in=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bios-logo-fade-out=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bios-logo-display-time=<replaceable>миллисекунды</replaceable></arg> + <arg>--bios-logo-image-path=<replaceable>путь</replaceable></arg> + <arg>--bios-boot-menu=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">menuonly</arg> + <arg choice="plain">messageandmenu</arg> + </group></arg> + <arg>--bios-apic=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">apic</arg> + <arg choice="plain">x2apic</arg> + </group></arg> + <arg>--bios-system-time-offset=<replaceable>миллисекунды</replaceable></arg> + <arg>--bios-pxe-debug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--system-uuid-le=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--boot<replaceable>X</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">floppy</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">disk</arg> + <arg choice="plain">net</arg> + </group></arg> + <arg>--rtc-use-utc=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--graphicscontroller=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">vboxvga</arg> + <arg choice="plain">vmsvga</arg> + <arg choice="plain">vboxsvga</arg> + </group></arg> + <arg>--snapshot-folder=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>путь</replaceable></arg> + </group></arg> + <arg>--firmware=<group choice="plain"> + <arg choice="plain">bios</arg> + <arg choice="plain">efi</arg> + <arg choice="plain">efi32</arg> + <arg choice="plain">efi64</arg> + </group></arg> + <arg>--guest-memory-balloon=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--default-frontend=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> +<!-- There are currently undocumented options --iocache and +--iocachesize which are scheduled for removal. Not worth spending +time on documenting it. --> + <arg>--vm-process-priority=<group choice="plain"> + <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></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--nic<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <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">hostonlynet</arg> + <arg choice="plain">generic</arg> + <arg choice="plain">natnetwork</arg> + </group></arg> + <arg>--nic-type<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">Am79C970A</arg> + <arg choice="plain">Am79C973</arg> + <arg choice="plain">82540EM</arg> + <arg choice="plain">82543GC</arg> + <arg choice="plain">82545EM</arg> + <arg choice="plain">virtio</arg> + </group></arg> + <arg>--cable-connected<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nic-trace<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></arg> + <arg>--nic-property<replaceable>N</replaceable>=<replaceable>имя</replaceable>= <arg><replaceable>значение</replaceable></arg></arg> + <arg>--nic-speed<replaceable>N</replaceable>=<replaceable>кбит-в-сек</replaceable></arg> + <arg>--nic-boot-prio<replaceable>N</replaceable>=<replaceable>приоритет</replaceable></arg> + <arg>--nic-promisc<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">deny</arg> + <arg choice="plain">allow-vms</arg> + <arg choice="plain">allow-all</arg> + </group></arg> + <arg>--nic-bandwidth-group<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--bridge-adapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--host-only-adapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--host-only-net<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--intnet<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--nat-network<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--nic-generic-drv<replaceable>N</replaceable>=<replaceable>имя-драйвера</replaceable></arg> + <arg>--mac-address<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">auto</arg> + <arg choice="plain"><replaceable>MAC-адрес</replaceable></arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking-nat"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--nat-net<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain"><replaceable>сеть</replaceable></arg> + <arg choice="plain">default</arg> + </group></arg> + <arg>--nat-pf<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">[<replaceable>имя-правила</replaceable>],tcp</arg> + <arg choice="plain">udp,[<replaceable>IP-хоста</replaceable>],<replaceable>порт-хоста</replaceable>,[<replaceable>IP-гостя</replaceable>],<replaceable>порт-гостя</replaceable></arg> + </group></arg> + <arg>--nat-pf<replaceable>N</replaceable>=delete=<replaceable>имя-правила</replaceable></arg> + <arg>--nat-tftp-prefix<replaceable>N</replaceable>=<replaceable>префикс</replaceable></arg> + <arg>--nat-tftp-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></arg> + <arg>--nat-tftp-server<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></arg> + <arg>--nat-bind-ip<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></arg> + <arg>--nat-dns-pass-domain<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-dns-proxy<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-dns-host-resolver<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-localhostreachable<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-settings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>отправка-сокет</replaceable>],[<replaceable>прием-сокет</replaceable>],[<replaceable>отправка-tcp</replaceable>],[<replaceable>прием-tcp</replaceable>]</arg> + <arg>--nat-alias-mode<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain">[log],[proxyonly],[sameports]</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-other-hardware"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--mouse=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + <arg choice="plain">usbtablet</arg> + <arg choice="plain">usbmultitouch</arg> + </group></arg> + <arg>--keyboard=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + </group></arg> + <arg>--uart<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-база</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--uart-mode<replaceable>N</replaceable>=<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></arg> + <arg>--uart-type<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">16450</arg> + <arg choice="plain">16550A</arg> + <arg choice="plain">16750</arg> + </group></arg> + <arg>--lpt-mode<replaceable>N</replaceable>=<replaceable>имя-устройства</replaceable></arg> + <arg>--lpt<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-база</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--audio-controller=<group choice="plain"> + <arg choice="plain">ac97</arg> + <arg choice="plain">hda</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audio-codec=<group choice="plain"> + <arg choice="plain">stac9700</arg> + <arg choice="plain">ad1980</arg> + <arg choice="plain">stac9221</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audio-driver=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">default</arg> + <arg choice="plain">null</arg> + <arg choice="plain">dsound</arg> + <arg choice="plain">was</arg> + <arg choice="plain">oss</arg> + <arg choice="plain">alsa</arg> + <arg choice="plain">pulse</arg> + <arg choice="plain">coreaudio</arg> + </group></arg> + <arg>--audio-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--audio-in=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--audio-out=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--clipboard-mode=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> +<!-- There is a currently undocumented option --clipboard-file-transfers. +The implementation is not finished, so postpone documenting until it +actually is ready for users. --> + <arg>--drag-and-drop=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> + <arg>--monitor-count=<replaceable>количество</replaceable></arg> + <arg>--usb-ehci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-ohci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-xhci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-rename=<replaceable>старое-имя</replaceable> <replaceable>новое-имя</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-recording"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--recording=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--recording-screens=<group choice="plain"> + <arg choice="plain">all</arg> + <arg choice="plain"><replaceable>ID-экрана</replaceable> [<replaceable>ID-экрана</replaceable>...]</arg> + </group></arg> + <arg>--recording-file=<replaceable>имя-файла</replaceable></arg> + <arg>--recording-max-size=<replaceable>МБ</replaceable></arg> + <arg>--recording-max-time=<replaceable>миллисекунды</replaceable></arg> + <arg>--recording-opts= <arg choice="plain"><replaceable>ключ</replaceable>=<replaceable>значение</replaceable> [,<replaceable>ключ</replaceable>=<replaceable>значение</replaceable>...]</arg></arg> + <arg>--recording-video-fps=<replaceable>кадров-в-сек</replaceable></arg> + <arg>--recording-video-rate=<replaceable>rate</replaceable></arg> + <arg>--recording-video-res=<replaceable>ширина</replaceable> <replaceable>высота</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-vrde"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--vrde=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-property=<replaceable>имя-свойства</replaceable>= <arg><replaceable>значение-свойства</replaceable></arg></arg> + <arg>--vrde-extpack=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> + <arg>--vrde-port=<replaceable>порт</replaceable></arg> + <arg>--vrde-address=<replaceable>IP-хоста</replaceable></arg> + <arg>--vrde-auth-type=<group choice="plain"> + <arg choice="plain">null</arg> + <arg choice="plain">external</arg> + <arg choice="plain">guest</arg> + </group></arg> + <arg>--vrde-auth-library=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> + <arg>--vrde-multi-con=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-reuse-con=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-video-channel=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-video-channel-quality=<replaceable>процент</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-teleport"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--teleporter=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--teleporter-port=<replaceable>порт</replaceable></arg> + <arg>--teleporter-address=<group choice="plain"> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + <arg choice="plain">empty</arg> + </group></arg> + <arg>--teleporter-password=<replaceable>пароль</replaceable></arg> + <arg>--teleporter-password-file=<group choice="plain"> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + <arg choice="plain">stdin</arg> + </group></arg> + <arg>--cpuid-portability-level=<replaceable>уровень</replaceable></arg> + <arg>--cpuid-set=<replaceable>лист</replaceable><arg>:<replaceable>подлист</replaceable></arg> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></arg> + <arg>--cpuid-remove=<replaceable>лист</replaceable><arg>:<replaceable>подлист</replaceable></arg></arg> + <arg>--cpuid-remove-all</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-debugging"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--tracing-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--tracing-config=<replaceable>строка</replaceable></arg> + <arg>--tracing-allow-vm-access=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-usbcardreader"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--usb-card-reader=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-autostart"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--autostart-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--autostart-delay=<replaceable>секунды</replaceable></arg> +<!-- There is a currently undocumented option --autostop-type. +Most autostart service implementations either ignore it or rely it is +left unchanged due to otherwise running into timeouts established by the +host OS, defeating the purpose. Not worth spending time on documenting +it unless this changes. --> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-pcipassthrough"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--pci-attach=<replaceable>PCI-адрес-хоста</replaceable><arg>@<replaceable>гостевой-PCI-адрес-шины</replaceable></arg></arg> + <arg>--pci-detach=<replaceable>PCI-адрес-хоста</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-testing"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--testing-enabled=<group choice="plain"><arg choice="plain">on</arg><arg choice="plain">off</arg></group></arg> + <arg>--testing-mmio=<group choice="plain"><arg choice="plain">on</arg><arg choice="plain">off</arg></group></arg> + <arg>--testing-cfg-dword<replaceable>idx</replaceable>=<replaceable>значение</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage modifyvm</command> позволяет изменить + свойства зарегистрированной неработающей на текущий момент + виртуальной машины (ВМ). + </para> + <para> + Большинство этих свойств соответствуют настройкам ВМ отображаемых + в диалоге <emphasis role="bold">Настройки</emphasis> Менеджера + VirtualBox для каждой ВМ. Смотрите <xref linkend="BasicConcepts" />. + Однако, некоторые настройки могут отображаться или управляться + только командой <command>VBoxManage</command>. + </para> + <para> + Можно использовать команду <command>VBoxManage modifyvm</command> + для изменения настроек только если ВМ выключена. ВМ не может быть + в работающем или сохраненном состоянии при использовании этой + команды. + </para> + <para> + Можно использовать команду <command>VBoxManage controlvm</command> + для изменения некоторых настроек ВМ динамически, пока ВМ работает. + Смотрите <xref linkend="vboxmanage-controlvm" />. + </para> + <refsect2 id="vboxmanage-modifyvm-general"> + <title>Общие настройки</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют вам изменить общую информаицю о вашей ВМ. + </para> + <para> + Команда <command>VBoxManage modifyvm</command> поддерживает следующие + опции: + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>имя-ВМ</replaceable></option></term> + <listitem><para> + Изменяет имя ВМ и связанных с ней внутренних файлов. Смотрите + <xref linkend="vboxmanage-createvm"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--groups=<replaceable>группа</replaceable></option></term> + <listitem><para> + Изменяет членство в группе для ВМ. Имена групп всегда + начинаются с символа слэш (<literal>/</literal>) и могут + быть вложены. По умолчанию, ВМ - члены группы + <literal>/</literal>. ВМ может входить в несколько групп, + но ее первичная группа определяет структуру директорий, + где внутренние файлы ВМ располагаются по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Изменяет необязательное описание ВМ. Используйте описание + для записи подробностей о ВМ в осмысленном виде. Графический + интерфейс понимает HTML разметку, тогда как команда + <command>VBoxManage modifyvm</command> позволяет включать + произвольный текст, который может содержать несколько строк. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--os-type=<replaceable>тип-ОС</replaceable></option></term> + <listitem><para> + Задает информацию о гостевой операционной системе (ОС) в ВМ. + Используйте команду <command>VBoxManage list ostypes</command> + для отображения идентификаторов типов ОС. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--icon-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает путь к файлу иконки ВМ в формате PNG в + хост-системе. Иконка отображается в интерфейсе Менеджера + ВМ и когда ВМ запущена в режиме графического интерфейса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--memory=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает количество оперативной памяти хоста, выделенной ВМ. + Размер в МБ. Смотрите <xref linkend="create-vm-wizard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--page-fusion=on | off</option></term> + <listitem><para> + Включает или отключает функцию Page Fusion, которая + по умолчанию отключена. Используйте функцию Page + Fusion для минимизации дублирования памяти между ВМ, + имеющих подобную конфигурацию и работающих на той же + хост-системе. Смотрите <xref linkend="guestadd-pagefusion" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vram=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает количество оперативной памяти, выделенной + графической карте. Смотрите <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--acpi=on | off</option></term> + <listitem><para> + Определяет поддерживает ли ВМ ACPI. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ioapic=on | off</option></term> + <listitem><para> + Определяет поддерживает ли ВМ I/O APIC. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hardware-uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) + для представления гостевой ВМ в таблицах памяти + (DMI/SMBIOS), в оборудовании и свойствах ВМ. По умолчанию + этот UUID оборудования такой же как UUID ВМ. Клонирование + и функция портирования автоматически сохраняет значение + UUID оборудования. Аналогично для экспорта и импорта + виртуальной конфигурации, но только если обе операции + выполняются &product-name;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpus=<replaceable>число-ЦПУ</replaceable></option></term> + <listitem><para> + Задает количество виртуальных ЦПУ, назначенных ВМ. + Смотрите <xref linkend="settings-processor" />. + </para><para> + Если горячее подключение ЦПУ включено, эта опция задает + максимальное количество виртуальных ЦПУ, которые можно + подключить к ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu-hotplug=on | off</option></term> + <listitem><para> + Включает или выключает горячее подключение ЦПУ. Когда + включено, можно динамически добавлять и удалять виртуальные + ЦПУ в ВМ. Смотрите <xref linkend="cpuhotplug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--plug-cpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Добавляет виртуальный ЦПУ в ВМ. + <replaceable>CPU-ID</replaceable> - это индекс добавляемого + вируального ЦПУ. Допустимое значение индекса - это число + от <literal>0</literal> до максимального количества ЦПУ, + заданных опцией <option>--cpus</option>. + </para><para> + Используйте эту опцию только когда включено горячее подключение ЦПУ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unplug-cpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Удалить виртуальный ЦПУ из ВМ. + <replaceable>CPU-ID</replaceable> - это индекс удаляемого + вируального ЦПУ. Допустимое значение индекса - это число + от <literal>1</literal> до максимального количества ЦПУ, + заданных опцией <option>--cpus</option>. + </para><para> + Используйте эту опцию только когда включено горячее подключение ЦПУ. + </para><para> + Обратите внимание, что нельзя удалить ЦПУ 0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuexectioncap=<replaceable>процент</replaceable></option></term> + <listitem><para> + Указывает, сколько времени ЦПУ может использовать + виртуальный ЦПУ. Допустимые значения от <literal>1</literal> + до <literal>100</literal>. Значение 50 показывает, что + единичные виртуальный ЦПУ может использовать до 50% + единичного ЦПУ хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pae=on | off</option></term> + <listitem><para> + Включает или выключает расширение физических адресов (PAE). + Смотрите <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--long-mode=on | off</option></term> + <listitem><para> + Включает или выключает длинный режим. Смотрите + <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-exit=on | off</option></term> + <listitem><para> + Включает использование барьера предсказателя неявных + ветвлений (IBPB) при каждом выходе из ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-entry=on | off</option></term> + <listitem><para> + Включает использование барьера предсказателя неявных + ветвлений (IBPB) при каждом входе в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--spec-ctrl=on | off</option></term> + <listitem><para> + Включает или выключает отображение интерфейсов управления + спекуляцией для гостевой ВМ. Эти интерфейсы должны + быть доступны в хост-системе. + </para><para> + В зависимости от ЦПУ хоста и нагрузки, включение + управления спекуляцией может значительно уменьшить + производительность. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-sched=on | off</option></term> + <listitem><para> + Включает или отключает сброс кэша данных L1, когда + поток запланирован на исполнение гостевого кода. Смотрите + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-vm-entry=on | off</option></term> + <listitem><para> + Включает или отключает сброс кэша данных L1 при каждом + входе в ВМ. Смотрите <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-sched=on | off</option></term> + <listitem><para> + Включает очистку буфера ЦПУ когда поток запланирован + на выполнение гостевого кода. Смотрите + <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-vm-entry=on | off</option></term> + <listitem><para> + Включает очистку буфера ЦПУ при каждом входе в ВМ. + Смотрите <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386</option></term> + <listitem><para> + Задает профиль, используемый для эмуляции гостевого + ЦПУ. Задайте значение, основанное на ЦПУ хост-системы + (<literal>host</literal>) или одной из следующих более + старых микроархитектурах Intel: <literal>8086</literal>, + <literal>80286</literal> или <literal>80386</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hpet=on | off</option></term> + <listitem><para> + Включает или выключает Таймер Событий Высокого + Разрешения (HPET), заменяющий устаревший системный + тайммер. Эта функция отключена по умолчанию. Заметим, + что HPET поддерживается в Windows начиная с Vista. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hwvirtex=on | off</option></term> + <listitem><para> + Включает или отключает использования расширение + виртуализации оборудования в процессоре хост-системы. + Такими расширениями являются Intel VT-x или AMD-V. + Смотрите <xref linkend="hwvirt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--triple-fault-reset=on | off</option></term> + <listitem><para> + Включает или отключает сброс гостевой ВМ вместо включения + медитации гуру. Некоторые гостевые ВМ вызывают тройной + сбой для сброса ЦПУ, поэтому иногда сброс гостевой ВМ - + это наилучший исход. Эта опция применяется только к + гостевым системам не использующих симметричную + многопроцессорность (SMP). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--apic=on | off</option></term> + <listitem><para> + Включает или выключает APIC. С APIC, ОС может + использовать более 16 запросов на прерывание (IRQ) + избегая совместное использование IRQ для улучшения + надежности. APIC включен по умолчанию. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--x2apic=on | off</option></term> + <listitem><para> + Включает или выключает функцию ЦПУ x2APIC. ЦПУ x2APIC + позволяет ОС работать более эффективно в конфигурациях + с большим количеством ядер и оптимизировать распределение + прерываний в виртуализированном окружении. Эта функция + включена по умолчанию. + </para><para> + Отключите эту функцию если ОС, работающая в хост-системе, + или гостевая ВМ не совместимы с ЦПУ x2APIC. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirt-provider=none | default | legacy | minimal | hyperv | kvm</option></term> + <listitem><para> + Указывает один из следующих интерфейсов + паравиртуализации предоставленный гостевой ОС: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> не предоставляет каких-либо + интерфейсов паравиртуализации. + </para></listitem> + <listitem><para> + <literal>default</literal> выбирает подходящий + интерфейс, основанный на типе гостевой ОС при старте + ВМ. Это значение по умолчанию при создании новой ВМ. + </para></listitem> + <listitem><para> + <literal>legacy</literal> выбирает интерфейс + паравиртуализации для ВМ, созданный более старыми + версиями &product-name;. + </para></listitem> + <listitem><para> + <literal>minimal</literal> требуется для гостевых ВМ + с Mac OS X. + </para></listitem> + <listitem><para> + <literal>kvm</literal> рекомендуется для гостевых ВМ + Linux. Смотрите <xref linkend="gimproviders" />. + </para></listitem> + <listitem><para> + <literal>hyperv</literal> рекомендуется для гостевых + ВМ Windows. Смотрите <xref linkend="gimproviders" />. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirt-debug=<replaceable>свойство</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает отладочные свойства, специфичные для провайдера + паравиртуализации, настроенного для указанной ВМ. + Смотрите <xref linkend="gimdebug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nested-paging=on | off</option></term> + <listitem><para> + Включает или отключает функцию вложенных страниц в + процессоре хост-системы. Эта опция доступна только + если аппаратная виртуализация включена. Смотрите + <xref linkend="hwvirt" /> и + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--large-pages=on | off</option></term> + <listitem><para> + Включает или отключает использование гипервизором + больших страниц, что может увеличить производительность + до 5%. Использование больших страниц уменьшает + использование TLB и накладные расходы. Эта опция + доступна только если включены и аппаратная виртуализация + и вложенные страницы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtx-vpid=on | off</option></term> + <listitem><para> + Включает или отключает использование функцию TLB c метками + (VPID) в процессоре вашей хост-системы. Смотрите + <xref linkend="hwvirt" />. Эта опция доступна только + если аппаратная виртуализация включена на Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtx-ux=on | off</option></term> + <listitem><para> + Включает или отключает использование неограниченного + гостевого режима для выполнения гостевой ВМ. Эта опция + доступна только когда аппаратная виртуализация включена + на Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nested-hw-virt=on | off</option></term> + <listitem><para> + Включает или отключает вложенну виртуализацию. Включение + делает доступной функцию аппаратной виртуализации в ВМ. + Смотрите <xref linkend="nested-virt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--virt-vmsave-vmload=on | off</option></term> + <listitem><para> + Если аппаратная виртуализация включена у хоста с ЦПУ AMD, + эта настройка включает или отключает использование функцию + виртуализированных vmsave/vmload во время исполнения ВМ. + Включена по умолчанию. Рекомендуется оставить включенной, + так как она имеет серьезное влияние на производительность + при выполнении вложенных ВМ при использовании вложенной + аппаратной виртуализации. + <xref linkend="nested-virt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated3d=on | off</option></term> + <listitem><para> + Включает или выключает аппаратное 3D ускорение для + графических адаптеров, поддерживающих это. Эта опция + работает только при установленных Дополнений Гостевой ОС. + Смотрите <xref linkend="guestadd-3d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated2dvideo=on | off</option></term> + <listitem><para> + Включает или отключает 2D видео ускорение для графических + адаптеров, поддерживающих это. Эта опция работает только + при установленных Дополнений Гостевой ОС. Смотрите + <xref linkend="guestadd-2d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--chipset=piix3 | ich9</option></term> + <listitem><para> + Задать чипсет Intel для эмуляции в &product-name;. + Значение по умолчанию - это чипсет Intel PIIX3 + (<literal>piix3</literal>). + </para><para> + Изменяйте это значение только если нужно ослабить + некоторые ограничения чипсета. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--iommu=none | automatic | amd | intel</option></term> + <listitem><para> + Указывает типа IOMMU для эмуляции в &product-name;. + И Intel и AMD IOMMU требуют в настоящее время использование + чипсета Intel ICH9 (Смотрите опцию <option>--chipset</option>). + </para><para> + Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – IOMMU отсутствует и это + значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>automatic</literal> – IOMMU присутствует, + но его тип выбирается автоматически, соответствуя + поставщику ЦПУ хоста при включении ВМ. + </para></listitem> + <listitem><para> + <literal>amd</literal> – AMD IOMMU присутствует. + </para></listitem> + <listitem><para> + <literal>intel</literal> – Intel IOMMU присутствует. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--tpm-type=none | 1.2 | 2.0 | host | swtpm</option></term> + <listitem><para> + Указывает тип TPM для эмуляции в &product-name;. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – TPM отсутствует и это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>1.2</literal> – TPM, соответствующий спецификации TCG 1.2, присутствует. + </para></listitem> + <listitem><para> + <literal>2.0</literal> – TPM, соответствующий спецификации TCG 2.0, присутствует. + </para></listitem> + <listitem><para> + <literal>host</literal> – TPM хост системы перенаправляется в гостевую систему. + Может быть доступен не на всех поддерживаемых хост платформах. + </para></listitem> + <listitem><para> + <literal>swtpm</literal> – ВМ подключается к эмуляции внешнего TPM, совместимого + с swtpm. Необходиму задать расположение TPM location для подключения (смотрите опцию + <option>--tpm-location</option>). + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-fade-in=on | off</option></term> + <listitem><para> + Указывает, появляется ли логотип BIOS при старте ВМ. По умолчанию + показывается логотип &product-name;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-fade-out=on | off</option></term> + <listitem><para> + Указывает, исчезает ли логотип BIOS при старте ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-display-time=<replaceable>msec</replaceable></option></term> + <listitem><para> + Задает время отображения логотипа BIOS в миллисекундах. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-image-path=<replaceable>pathname</replaceable></option></term> + <listitem><para> + Заменяет существующий логотип BIOS другим изображением. + Заменяющее изображение должно быть несжатым 16-, 256- или + 16М-цветным файлом bitmap (BMP), не содержащим информацию о + цветовом пространстве (формат Windows 3.0). Также убедитесь + что изображение не больше 640x480 пикселов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-boot-menu=disabled | menuonly | messageandmenu</option></term> + <listitem><para> + Указывает, позволяет ли BIOS выбрать временное + загрузочное устройство. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>disabled</literal> выводит сообщение об + альтернативном загрузочном устройстве и позволяет + выбрать временное загрузочное устройство нажатием F12. + </para></listitem> + <listitem><para> + <literal>menuonly</literal> подавляет вывод сообщения + об альтернативном загрузочном устройстве, но позволяет + выбрать временное загрузочное устройство нажатием F12. + </para></listitem> + <listitem><para> + <literal>messageandmenu</literal> подавляет сообщение + об альтернативном загрузочном устройстве и предотвращает + выбор временного загрузочного устройства нажатием F12. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-apic=x2apic | apic | disabled</option></term> + <listitem><para> + Задает уровень APIC для прошивки. Допустимые значения: + <literal>x2apic</literal>, <literal>apic</literal> + и <literal>disabled</literal>. Когда значение + <literal>disabled</literal>, ни версия <literal>apic</literal> + ни версия <literal>x2apic</literal> не используются. + </para><para> + Заметим, что если указать значение <literal>x2apic</literal> + и x2APIC не поддерживается виртуальным ЦПУ, уровень + APIC снижается до <literal>apic</literal>, если он + поддерживается. Иначе, уровень APIC снижается до + <literal>disabled</literal>. Аналогично, если указать + значение <literal>apic</literal> и APIC не поддерживается + виртуальным ЦПУ, уровень APIC снижается до + <literal>disabled</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-system-time-offset=<replaceable>миллисекунды</replaceable></option></term> + <listitem><para> + Задает смещение времени в миллисекундах для гостевой ВМ + по отношению ко времени в хост-системе. Если значение + положительное, время в гостевой ВМ опережает время + хост-системы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-pxe-debug=on | off</option></term> + <listitem><para> + Включает или отключает дополнительный отладочный вывод при + использовании загрузочного ROM Intel PXE. Отладочный вывод + записывается в файл журнала в режиме выпуска. Смотрите + <xref linkend="collect-debug-info" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--system-uuid-le=on | off</option></term> + <listitem><para> + Включает или выключает представление системного UUID в + форме little endian. + Значение по умолчанию <literal>on</literal> для новых ВМ. + Для старых ВМ значение <literal>off</literal> чтобы сохранить + содержиммое таблицы DMI/SMBIOS неизменным, что может быть + важно для активации лицензии Windows. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot<replaceable>N</replaceable>=none | floppy | dvd | disk | net</option></term> + <listitem><para> + Позволяет указать порядок загрузочных устройств для ВМ + через назначение одного из типов устройств на каждый из + четырех слотов загрузочных устройств, представленных + <replaceable>N</replaceable> в имени опции. + </para><para> + Значение 1 для в <replaceable>N</replaceable> представляет + первое загрузочное устройство, и так далее. + </para><para> + Типы устройств - это <literal>floppy</literal> для флоппи + дисков, <literal>dvd</literal> для DVD или CD, + <literal>disk</literal> для жестких дисков и + <literal>net</literal> для сетевых устройств. Значение + <literal>none</literal> показывает, что загрузочное устройство + на указанный слот не назначено. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--rtc-use-utc=on | off</option></term> + <listitem><para> + Указывает, что часы реального времени (RTC) используют + скоординированное универсальное время (UTC). Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--graphicscontroller=none | vboxvga | vmsvga | vboxsvga</option></term> + <listitem><para> + Задает используемый тип графического контроллера. + Смотрите <xref linkend="settings-screen" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--snapshot-folder=default | <replaceable>путь</replaceable></option></term> + <listitem><para> + Указывает имя папки для хранения снимков ВМ. + <literal>default</literal> означает + <filename>Snapshots/</filename> в папке машины. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--firmware=bios | efi | efi32 | efi64</option></term> + <listitem><para> + Указывает прошивку, используемую для загрузки ВМ. Допустимые + значения: <literal>bios</literal>, <literal>efi</literal>, + <literal>efi32</literal> или <literal>efi64</literal>. + Используйте значения EFI с осторожностью. + </para><para> + По умолчанию используется прошивка BIOS. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--guest-memory-balloon=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает размер гостевого memory balloon. Гостевой memory + balloon - это память выделенная Дополнениями Гостевой ОС + из гостевой ОС и возвращенная гипервизору для использования + другими ВМ. Указывайте <replaceable>размер</replaceable> + в мегабайтах. Значение по умолчанию <literal>0</literal> + мегабайт. Смотрите <xref linkend="guestadd-balloon" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--default-frontend=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Указывает фронтенд по умолчанию, используемый при + старте указанной ВМ. Если указать <literal>default</literal>, + ВМ запускается в окне рабочего стола пользователя. + Смотрите <xref linkend="vboxmanage-startvm" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vm-process-priority=default | flat | low | normal | high</option></term> + <listitem><para> + Задает схему приоритета, используемую при старте + и работе указанной ВМ. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>default</literal> – Приоритет процесса + по умолчанию, опрелеляемый ОС. + </para></listitem> + <listitem><para> + <literal>flat</literal> – предполагает политику + планирования, которая устанавливает для процесса + приоритет по умолчанию, при этом, всем потокам процесса + устанавливается один и тот же приоритет. + </para></listitem> + <listitem><para> + <literal>low</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + в основном ниже приоритета по умолчанию ОС хоста. + </para></listitem> + <listitem><para> + <literal>normal</literal> – Предполагает политику + планирования, которая честно разделяет ресурсы ЦПУ с + другими процессами, имеющими приоритет по умолчанию + ОС хоста. + </para></listitem> + <listitem><para> + <literal>high</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + выше приоритета по умолчанию ОС хоста. Эта политика + может повлиять на другие процессы, заставляя их ожидать + ресурса ЦПУ больше положенного времени, что может + привести к непредсказуемому поведению. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking"> + <title>Сетевые настройки</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменять сеть в вашей ВМ. Во всех + этих опциях, <replaceable>N</replaceable> - это число больше + нуля, представляющее определенный виртуальный сетевой адаптер, + настраиваемый в данный момент. + </para> + <variablelist> + <varlistentry> + <term><option>--nic<replaceable>N</replaceable>=none | null | nat | natnetwork | bridged | intnet | hostonly | generic</option></term> + <listitem><para> + Настраивает тип сети используемый каждой виртуальной + сетевой картов в ВМ. + </para><para> + Следующие допустимые значения соответствуют режимам, + описанных в<xref linkend="networkingmodes" />: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – Сеть отсутствует + </para></listitem> + <listitem><para> + <literal>null</literal> – Не подключен к хост-системе + </para></listitem> + <listitem><para> + <literal>nat</literal> – Используется преобразование адресов (NAT) + </para></listitem> + <listitem><para> + <literal>natnetwork</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>generic</literal> – Доступ к редко используемым подрежимам + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-type<replaceable>N</replaceable>=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio</option></term> + <listitem><para> + Идентифицирует тип сетевого оборудования, которое + &product-name; представляет гостевой ВМ для указанной + виртуальной сетевой карты. Смотрите + <xref linkend="nichardware" />. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>Am79C970A</literal> представляет AMD PCNet + PCI II. + </para></listitem> + <listitem><para> + <literal>Am79C973</literal> представляет AMD PCNet + FAST III, что является значением по умолчанию. + </para></listitem> + <listitem><para> + <literal>82540EM</literal> представляет Intel + PRO/1000 MT Desktop. + </para></listitem> + <listitem><para> + <literal>82543GC</literal> представляет Intel + PRO/1000 T Server. + </para></listitem> + <listitem><para> + <literal>82545EM</literal> представляет Intel + PRO/1000 MT Server. + </para></listitem> + <listitem><para> + <literal>virtio</literal> представляет паравиртуализированный + сетевой адаптер. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--cable-connected<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Временно отсоединяет виртуальный сетевой интерфейс, как + будто вы вытащили сетевой кабель из физического сетевого + интерфейса. Можно использовать эту опцию для сброса + определенных программных компонентов в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-trace<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Включает или выключает трассировку сети для указанной + сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к файлу, куда записывать информаицю + журнала трассировки. Используйте эту опцию если включена + трассировка сети. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-property<replaceable>N</replaceable>=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Позволяет задать значения свойств и передать их редко + используемым сетевым бэкендам. Для использования этой + опции, необходимо также использовать опцию + <option>--nic-generic-drv</option>. + </para><para> + Свойства относятся к движку бэкенда и отличаются между + UDP туннелем и драйверами бэкенда VDE. В качестве + примера смотрите + <xref linkend="network_udp_tunnel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-speed<replaceable>N</replaceable>=<replaceable>кбит-в-сек</replaceable></option></term> + <listitem><para> + Указывает пропускную способность в килобит в секунду для + редко используемых сетевых подрежимов, таких как сеть + VDE и UDP туннель. Используйте эту опцию, только если + использована опция <option>--nic</option> для включения + generic сети для указанной виртуальной сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-boot-prio<replaceable>N</replaceable>=<replaceable>приоритет</replaceable></option></term> + <listitem><para> + Назначает приоритет для каждой NIC, что определяет порядок, + в котором соответствующий NIC используется для сетевой + загруки PXE. Значение приоритета - это число в диапазоне + от <literal>0</literal> до <literal>4</literal>. + Приоритет <literal>0</literal>, который является значением + по умолчанию, представляет наименьший приоритет. Приоритет + <literal>1</literal> - это наибольший приоритет, а + приоритеты <literal>3</literal> и <literal>4</literal> - + ниже. + </para><para> + Эта опция работает только когда используется загрузочный + ROM Intel PXE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-promisc<replaceable>N</replaceable>=deny | allow-vms | allow-all</option></term> + <listitem><para> + Позволяет указать разрешен или запрещен неразборчивый + режим указанной виртуальной сетевой карты ВМ. Эта опция + имеет значение только для сетевого моста. + Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>deny</literal> прячет любой траффик, не + предназначенный данной ВМ. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>allow-vms</literal> прячет весь траффик хоста, + но разрешает ВМ просматривать траффик других ВМ. + </para></listitem> + <listitem><para> + <literal>allow-all</literal> разрешает ВМ просматривать + весь траффик. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-bandwidth-group<replaceable>N</replaceable>=none | <replaceable>имя</replaceable></option></term> + <listitem><para> + Добавляет или удаляет назначение группы полосы пропускания + к указанной виртуальной сетевой карте. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> удаляет любое текущее назначение + группы полосы пропускания из указанного виртуального + сетевого интерфейса. + </para></listitem> + <listitem><para> + <replaceable>имя</replaceable> добавляет назначение группы + полосы пропускания к указанному виртуальному сетевому + интерфейсу. + </para></listitem> + </itemizedlist><para> + Смотрите <xref linkend="network_bandwidth_limit" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bridge-adapter<replaceable>N</replaceable>=none | <replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Указывает интерфейс хоста используемого в указанном + виртуальном сетевом интерфейсе. Смотрите + <xref linkend="network_bridged" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения сетевого моста для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--host-only-adapter<replaceable>N</replaceable>=none | <replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Указывает интерфейс сети хоста используемого в указанном + виртуальном сетевом интерфейсе. Смотрите + <xref linkend="network_hostonly" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения сети хоста для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--intnet<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></option></term> + <listitem><para> + Указывает имя внутренней сети. Смотрите + <xref linkend="network_internal" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения внутренней сети для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-network<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></option></term> + <listitem><para> + Указывает имя сети NAT, куда подключен адаптер. + Используйте эту опцию только если тип сети + <literal>natnetwork</literal>, а не <literal>nat</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-generic-drv<replaceable>N</replaceable>=<replaceable>драйвер-бэкенда</replaceable></option></term> + <listitem><para> + Позволяет получить доступ к редко используемым сетевым + подрежимам, таких как сети VDE и UDP туннель. + Используйте эту опцию, только если использована опция + <option>--nic</option> для включения generic сети для + указанной виртуальной сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mac-address<replaceable>N</replaceable>=auto | <replaceable>MAC-адрес</replaceable></option></term> + <listitem><para> + Указывает MAC адрес указанного сетевого адаптера ВМ. + По умолчанию, &product-name; назначает случайный MAC + адрес на каждый сетевой адаптер при создании ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking-nat"> + <title>Настройкт сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + В следующих опциях, используйте <replaceable>N</replaceable> + для указания определенного виртуального сетевого адаптера, + где нужно произвести изменения. + </para> + <variablelist> + <varlistentry> + <term><option>--nat-net<replaceable>N</replaceable>=default | <replaceable>сеть</replaceable></option></term> + <listitem><para> + Указывает диапазон IP адресов используемый в этой сети. + Смотрите <xref linkend="changenat" />. Используйте эту опцию + только если тип сети <literal>nat</literal>, а не + <literal>natnetwork</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-pf<replaceable>N</replaceable>=[<replaceable>имя</replaceable>],tcp | udp,[<replaceable>IP-хоста</replaceable>],<replaceable>порт-хоста</replaceable>,[<replaceable>IP-гостя</replaceable>],<replaceable>порт-гостя</replaceable></option></term> + <listitem><para> + Указывает используемое правило перенаправления портов NAT. + Смотрите <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-pf<replaceable>N</replaceable>=delete <replaceable>имя</replaceable></option></term> + <listitem><para> + Указывает правило перенаправления портов NAT для удаления. + Смотрите <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-prefix<replaceable>N</replaceable>=<replaceable>префикс</replaceable></option></term> + <listitem><para> + Задает префикс, используемый во встроенном TFTP сервере. + Например, можно использовать префикс, для указания, где + расположен загрузочный файл. Смотрите <xref linkend="nat-tftp" /> + и <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-file<replaceable>N</replaceable>=<replaceable>загрузочный-файл</replaceable></option></term> + <listitem><para> + Задает имя загрузочного файла TFTP. Смотрите + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-server<replaceable>N</replaceable>=<replaceable>сервер-tftp</replaceable></option></term> + <listitem><para> + Задает адрес сервера TFTP, откуда загружаться. Смотрите + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-bind-ip<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает альтернативный IP адрес, на который привязывается + движок NAT. Смотрите <xref linkend="nat-adv-settings" />. + По умолчанию, движок NAT &product-name; перенаправляет пакеты TCP/IP + через интерфейс по умолчанию, назначенный TCP/IP стеком хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-pass-domain<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, передает ли встроенный DHCP сервер имя домена + для разрешения сетевого имени. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-proxy<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT - это прокси для всех запросов DNS + из гостевых систем в DNS серверы хост-системы. Смотрите + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-host-resolver<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT использует механизм разрешения + хост-системы для обработки DNS запросов. Смотрите + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-localhostreachable<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT разрешает траффик из гостя направленный на + 10.0.2.2 передавать в локальную петлю хоста, то есть localhost или 127.0.0.1. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-settings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>отправка-сокет</replaceable>],[<replaceable>прием-сокет</replaceable>],[<replaceable>отправка-tcp</replaceable>],[<replaceable>прием-tcp</replaceable>]</option></term> + <listitem><para> + Задает значения для настройки производительности NAT. + Смотрите <xref linkend="nat-adv-settings" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-alias-mode<replaceable>N</replaceable>=default | [log],[proxyonly],[sameports]</option></term> + <listitem><para> + Задает поведение ядра движка NAT: + </para><itemizedlist> + <listitem><para> + <literal>log</literal> включает журналирование + </para></listitem> + <listitem><para> + <literal>proxyonly</literal> выключает режим + псеводонимов и делает NAT прозрачным + </para></listitem> + <listitem><para> + <literal>sameports</literal> заставляет движок NAT + отправлять пакеты через тот же порт, с которого + они пришли + </para></listitem> + <listitem><para> + <literal>default</literal> выключает все режимы псевдонимов. + </para></listitem> + </itemizedlist><para> + Для более подробной информации смотрите + <xref linkend="nat-adv-alias" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-other-hardware"> + <title>Другие настройки оборудования</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют настроить другое оборудование, такое + как последовательный порт, монитор, аудио устройство, USB порты, + буфер обмена и функционал Drag and Drop. + </para> + <variablelist> + <varlistentry> + <term><option>--mouse=ps2 | usb | usbtablet | usbmultitouch</option></term> + <listitem><para> + Задает режим мыши в ВМ. Допустимые значения: + <literal>ps2</literal>, <literal>usb</literal>, + <literal>usbtablet</literal> и <literal>usbmultitouch</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--keyboard=ps2 | usb</option></term> + <listitem><para> + Задает режим клавиатуры в ВМ. Допустимые значения: + <literal>ps2</literal> и <literal>usb</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart<replaceable>N</replaceable>=off | <replaceable>I/O-база</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Настраивает виртуальные последовательные порты ВМ. + <replaceable>N</replaceable> представляет модифицируемый + последовательный порт. Допустимые значения + <literal>off</literal>, отключающее порт или базу I/O и + IRQ. Для информации по значениям базы I/O и IRQ традиционных + COM портов смотрите <xref linkend="serialports" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart-mode<replaceable>N</replaceable>=<replaceable>режим</replaceable></option></term> + <listitem><para> + Указывает, как &product-name; соединяет указанный + виртуальный последовательный порт к хост-системе, где + работает ВМ. Смотрите <xref linkend="serialports" />. + </para><para> + Убедитесь, что сначала настроили виртуальный последовательный + порт через опцию <option>--uart<replaceable>N</replaceable></option>. + </para><para> + Задайте один из следующих режимов соединения для каждого порта: + </para><itemizedlist> + <listitem><para> + <literal>disconnected</literal> показывает что, даже + если последовательный порт отображается в гостевой ВМ, + он не подключен. Это состояние подобно физическому + COM порту без подключенного кабеля. + </para></listitem> + <listitem><para> + <literal>server</literal> + <replaceable>имя-канала</replaceable> создает + указанный именованный канал или сокет локального + домена в хост системе и присоединяет виртуальное + последовательное устройство к нему. + </para><para> + В хост-системе Windows <replaceable>имя-канала</replaceable> - + это именованный канала с именем в следующем формате: + <literal>\\.\pipe\<replaceable>имя-канала</replaceable></literal>. + </para><para> + В хост-системе Linux, + <replaceable>имя-канала</replaceable> это сокет локального + домена. + </para></listitem> + <listitem><para> + <literal>client</literal> + <replaceable>имя-канала</replaceable> подключает + виртуальное последовательное устройство к указанному + именованному каналу или сокету локального домена. + </para><para> + Заметим, что именованный канал или сокет локального домена + должны уже существовать. + </para></listitem> + <listitem><para> + <literal>tcpserver</literal> + <replaceable>порт</replaceable> создает сокет TCP + с указанным портом TCP в хост-системе и подключает + виртуальное последовательное устройство к нему. + </para><para> + В UNIX-подобных системах используйте порты больше + 1024 для не-root пользователей. + </para></listitem> + <listitem><para> + <literal>tcpclient</literal> + <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable> + поключает виртуальное последовательное устройство к + сокету TCP. + </para><para> + Заметим, что TCP сокет должен уже существовать. + </para></listitem> + <listitem><para> + <literal>file</literal> + <replaceable>имя-файла</replaceable> перенаправляет + вывод последовательного порта в указанный файл. + Убедитесь, что <replaceable>имя-файла</replaceable> - + это абсолютный путь к файлу в хост-системе. + </para></listitem> + <listitem><para> + <replaceable>имя-устройства</replaceable> задает имя + устройства физического аппаратного последовательного + порта в указанной хост-системе, куда подсоединяется + виртуальный последовательный порт. + </para><para> + Используйте этот режим для подключения физического + последовательного порта к ВМ. + </para><para> + В хост-системах Windows имя устройства это COM порт + такой как <literal>COM1</literal>. В хост-системах Linux + имя устройства подобно <filename>/dev/ttyS0</filename>. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart-type<replaceable>N</replaceable>=<replaceable>тип-UART</replaceable></option></term> + <listitem><para> + Настраивает тип UART для указанного виртуального последовательного + порта (<replaceable>N</replaceable>). Допустимые значения + <literal>16450</literal>, <literal>16550A</literal> и + <literal>16750</literal>. Значение по умолчанию + <literal>16550A</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lpt-mode<replaceable>N</replaceable>=<replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Задает имя устройства используемого параллельного порта. + </para><para> + В хост-системах Windows используйте имя устройства как + <command>lpt1</command>. В хост-системах Linux, + используйте имя устройства как <filename>/dev/lp0</filename>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lpt<replaceable>N</replaceable>=<replaceable>I/O-база</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Задает базовый адрес I/O и IRQ параллельного порта. + </para><para> + Можно посмотреть базовый адрес I/O и IRQ, используемый + для параллельного порта, в менеджере устройств. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-controller=<replaceable>тип-контроллера</replaceable></option></term> + <listitem><para> + Задает аудио контроллер, используемый в ВМ. + Допустимые значения: + <literal>ac97</literal>, <literal>hda</literal> и + <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-codec=<replaceable>тип-кодека</replaceable></option></term> + <listitem><para> + Указывает аудио кодек, используемый в ВМ. Допустимые + значения: <literal>stac9700</literal>, + <literal>ad1980</literal>, <literal>stac9221</literal> + и <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-driver=<replaceable>тип</replaceable></option></term> + <listitem><para> + Указывает, что ВМ имеет поддержку аудио определенного типа. + Допустимые значения: + <literal>none</literal>, <literal>default</literal>, + <literal>null</literal>, <literal>dsound</literal>, + <literal>was</literal>, <literal>oss</literal>, + <literal>alsa</literal>, <literal>pulse</literal> и + <literal>coreaudio</literal>. + </para><para> + Заметим, что типы аудио зависят от операционной системы + хоста. Вывод справки по команде <command>VBoxManage + modifyvm</command> поможет определить поддерживаемые + типы аудио для вашей операционной системы. + </para> + <para> + Для обеспечения максимальной совместимости между хостами можно + использовать стандартный аудиодрайвер по + умолчанию. В этом случае, виртуальная машина автоматически выберет + наиболее подходящий аудиодрайвер для текущего доступного хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-enabled=on|off</option></term> + <listitem><para> + Указывает, следует ли включить или отключить звук для виртуальной + машины. + </para> + <para> + Эта опция имеет приоритет над опциями --audio-in и --audio-out, + т.е. отключение звука с помощью этой опции приведет к полному отключению + как входного, так и выходного звука. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-in=on|off</option></term> + <listitem><para> + Указывает, включать или нет аудио захват из хост-системы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-out=on|off</option></term> + <listitem><para> + Указывает, включать или нет воспроизведение аудио из + гостевой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--clipboard-mode=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает, как предоставляются данные буфера обмена + между гостевой ВМ и хост-системой. + Допустимые значения: <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и + <literal>bidirectional</literal>. Смотрите + <xref linkend="generalsettings" />. + </para><para> + Функционал буфера обмена доступен только если + Дополнения Гостевой ОС установлены в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--drag-and-drop=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает, как используется функция drag and drop между + хост-системой и ВМ. Допустимые значения: + <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и + <literal>bidirectional</literal>. Смотрите + <xref linkend="guestadd-dnd" />. + </para><para> + Функционал drag and drop доступен только если + Дополнения Гостевой ОС установлены в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--monitor-count=<replaceable>количество</replaceable></option></term> + <listitem><para> + Позволяет настроить несколько мониторов. Смотрите + <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-ohci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 1.1 контроллер ВМ. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-ehci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 2.0 контроллер ВМ. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-xhci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 3.0 контроллер ВМ. + Это наиболее эффективная опция если ВМ поддерживает его. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-rename=<replaceable>старое-имя</replaceable> <replaceable>новое-имя</replaceable></option></term> + <listitem><para> + Переименовывает виртуальный USB контроллер ВМ из + <replaceable>старое-имя</replaceable> в + <replaceable>новое-имя</replaceable>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-recording"> + <title>Настройки записи</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменить настройки записи видео, + записи аудио или обоих. + </para> + <variablelist> + <varlistentry> + <term><option>--recording=on | off</option></term> + <listitem><para> + Включает или отключает запись сессии ВМ в файл WebM или + VP8. Когда установлен в <literal>on</literal>, запись + начинается при старте сессии ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-screens=all | <replaceable>ID-экрана</replaceable></option></term> + <listitem><para> + Позволяет указать записываемый экран ВМ. С каждого экрана + запись ведется в свой файл. Допустимые значения: + <literal>all</literal>, то есть запись со всех экранов + или один или несколько указанных экранов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает имя файла куда сохранять запись. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-max-size=<replaceable>МБ</replaceable></option></term> + <listitem><para> + Задает максимальный размер файла записанного видео в + мегабайтах. Когда файл достигает указанного размера, + запись останавливается. Если указано значение + <literal>0</literal>, запись продолжается пока не будет + остановлена вручную. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-max-time=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает максимальное записываемое время в секундах. + При достижении указанного времени запись останавливается. + Если указано значение <literal>0</literal>, запись + продолжается пока не будет остановлена вручную. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-opts=<replaceable>ключ</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает дополнительные свойства записи видео как + разделенный запятыми список свойств в виде ключ-значение. + Например <literal>foo=bar,a=b</literal>. + </para><para> + Используйте эту опцию, только если вы опытный пользователь. + Информацию о ключах смотрите в <citetitle>Oracle VM + VirtualBox Programming Guide and Reference</citetitle>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-fps=<replaceable>кадров-в-сек</replaceable></option></term> + <listitem><para> + Задает максимальное количество записываемых видеокадров + в секунду (FPS). Запись игнорирует все кадры с более + высокой частотой. Если увеличить FPS, меньше кадров + будет проигнорировано но запись и размер файла с + записью увеличится. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-rate=<replaceable>битрейт</replaceable></option></term> + <listitem><para> + Задает битрейт видео в килобит в секунду. Если увеличить + битрейт, качество записи улучшится но и размер записанного + файла также увеличится. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-res=<replaceable>ширина</replaceable>x<replaceable>высота</replaceable></option></term> + <listitem><para> + Задает разрешение записанного видео (ширина и высота) + в пикселах. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-vrde"> + <title>Настройки удаленной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменить поведение расширения + удаленного рабочего стола VirtualBox (VRDE). + </para> + <variablelist> + <varlistentry> + <term><option>--vrde=on | off</option></term> + <listitem><para> + Включает или отключает сервер VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=TCP/Ports=<replaceable>порт</replaceable></option></term> + <listitem><para> + <replaceable>порт</replaceable> - это порт или диапазон + портов на которые подключается сервер VRDE. Значения + <literal>default</literal> или <literal>0</literal> + используют порт <literal>3389</literal>. Это стандартный + порт RDP. + </para><para> + Также cмотрите описание опции <option>--vrde-port</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=TCP/Address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + <replaceable>IP-адрес</replaceable> - это IP адрес + интерфейса сети хоста, к которому подключается сервер + VRDE. Когда указана, сервер принимает подключения только + на интерфейс сети хоста с этим IP адресом. + </para><para> + Также cмотрите описание опции <option>--vrde-address</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=VideoChannel/Enabled=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает включен ли видеоканал VRDP или нет. + <literal>1</literal> значит <literal>on</literal> и + <literal>0</literal> значит <literal>off</literal>. + Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Quality=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает значение между 10% и 100% включительно. Она + представляет уровень сжатия JPEG в видеоканале сервера + VRDE. Меньшее значение приводит к худшему качеству JPEG + но более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DownscaleProtection=<replaceable>значение</replaceable></option></term> + <listitem><para> + Включает или отключает функцию защиты от уменьшения + масштаба. Допустимые значения <literal>1</literal> + включающая функцию и <literal>0</literal>, отключающую ее. + </para><para> + Когда эта функция включена, &product-name; определяет + отображать ли видео: + </para><itemizedlist> + <listitem><para> + Когда размер видео соответствуют размеру теневого + буфера, видео рассматривается как полноэкранное и + отображается. + </para></listitem> + <listitem><para> + Когда размер видео между полным экраном и порогом + уменьшения масштаба, видео не отображается. Такое + видео может быть окном приложения, нечитаемым при + уменьшении масштаба. + </para></listitem> + </itemizedlist><para> + Когда эта функция отключена, все равно производится попытка + отобразить видео. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableDisplay=1</option></term> + <listitem><para> + Отключает функцию отображения сервера VRDE. + </para><para> + Для повторного включения этой функции, назначьте пустое + значение. Например, для включения функии отображения + укажите команду <command>VBoxManage modifyvm + --vrde-property=Client/DisableDisplay=</command>. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableInput=1</option></term> + <listitem><para> + Отключает функцию ввода сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableAudio=1</option></term> + <listitem><para> + Отключает функцию аудио сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableUSB=1</option></term> + <listitem><para> + Отключает функцию USB сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableClipboard=1</option></term> + <listitem><para> + Отключает функцию буфера обмена сервера VRDE. Для + включения этой функции, назначьте пустое значение. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableUpstreamAudio=1</option></term> + <listitem><para> + Отключает функцию передачи аудио на сервер VRDE. + Для включения этой функции назначьте пустое значение. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableRDPDR=1</option></term> + <listitem><para> + Отключает функцию RDP перенаправления устройств для + смарт-карт сервера VRDE. Для включения этой функции + назначьте пустое значение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=H3DRedirect/Enabled=1</option></term> + <listitem><para> + Включает функию перенаправления 3D сервера VRDE. Для + включения этой функции назначьте пустое значение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Security/Method=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает следующую информаицю, требуемую для подключения: + </para><itemizedlist> + <listitem><para> + <literal>Negotiate</literal> показывает, что разрешены + подключения, имеющие и расширенную (TLS) и стандартную + безопасность RDP. Метод безопасности согласуется с + клиентом. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>RDP</literal> показывает, что принимается только + подключение, имеющее стандартную безопасность RDP. + </para></listitem> + <listitem><para> + <literal>TLS</literal> показывает, что принимается только + подключение, имеющее расширенную безопасность RDP. Клиент + должен поддерживать TLS. + </para></listitem> + </itemizedlist><para> + Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=ServerCertificate=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к сертификату сервера. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=ServerPrivateKey=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к приватному ключу сервера. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=CACertificate=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к корневому самоподписанному + сертификату. Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property Audio/RateCorrectionMode=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает режим подключения аудио или путь к файлу аудио + журнала. Допустимые значения: + </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> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=LogPath=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к файлу аудио журнала. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-extpack=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Задает библиотеку, используемую для удаленного доступа + к ВМ. Значение <literal>default</literal> использует + код RDP, который является частью пакета расширения + &product-name;. + </para><para> + Для использования модуля VRDE в VNC, укажите + <literal>VNC</literal>. Смотрите + <xref linkend="otherextpacks"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-port=default | <replaceable>порт</replaceable></option></term> + <listitem><para> + <replaceable>порт</replaceable> - это порт или диапазон + портов на которые подключается сервер VRDE. Значение + <literal>default</literal> или <literal>0</literal> + использует порт <literal>3389</literal>, который + является стандартным портом RDP. + </para><para> + Можно указать разделенный запятыми список портов или + диапазонов портов. Используйте дефис между двумя + номерами портов для задания диапазона. Сервер VRDE + подключается только к одному доступному порту из списка. + В один и тот же момент, только одна машина может + использовать данный порт. Например, опция + <option>--vrde-port=5000,5010-5012</option> указывает, + что сервер может подключиться на один из следующих портов: + <literal>5000</literal>, <literal>5010</literal>, + <literal>5011</literal> или <literal>5012</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает IP адрес интерфейса сети хоста, на который + подключается сервер VRDE. Если указать IP адрес, сервер + VRDE принимает подключения только с указанного + интерфейса сети хоста. + </para><para> + Используйте эту опцию для указания, что сервер VRDP + должен принимать IPv4, IPv6 или оба тип соединений: + </para><itemizedlist> + <listitem><para> + <emphasis role="bold">Только IPv4:</emphasis> + Используйте опцию + <option>--vrde-address="0.0.0.0"</option>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Только IPv6:</emphasis> + Используйте опцию + <option>--vrde-address="::"</option>. + </para></listitem> + <listitem><para> + <emphasis role="bold">И IPv6 и IPv4:</emphasis> + Используйте опцию <option>--vrde-address=""</option>. + Это значение по умолчанию. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-auth-type=null | external | guest</option></term> + <listitem><para> + Указывает использовать ли авторизацию и как ее проводить. + Смотрите <xref linkend="vbox-auth" />. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>null</literal> - без аутентификации. + </para></listitem> + <listitem><para> + <literal>external</literal> - внешняя аутентификация + через библиотеку аутентификации. + </para></listitem> + <listitem><para> + <literal>guest</literal> - аутентификация через + гостевые пользовательские учетные записи. Этот + неподдерживаемый метод требует установки Дополнений + Гостевой ОС в ВМ. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-auth-library=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Задает библиотеку, используемую для аутентификации RDP. + Библиотека по умолчанию для внешней аутентификации + <filename>VBoxAuth</filename>. Смотрите + <xref linkend="vbox-auth" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-multi-con=on | off</option></term> + <listitem><para> + Включает или отключает функцию множественных подключений + к серверу VRDE, если поддерживается. Смотрите + <xref linkend="vrde-multiconnection" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-reuse-con=on | off</option></term> + <listitem><para> + Задает поведение сервера VRDE когда множественные + подключения отключены. Когда значение + <literal>on</literal>, сервер разрешает подключение + нового клиента и разрывает существующее. Когда значение + <literal>off</literal>, новое подключение не принимается + если клиент уже подключен к серверу. Это значение + по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-video-channel=on | off</option></term> + <listitem><para> + Включает перенаправление видео, если поддерживается сервером + VRDE. Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-video-channel-quality=<replaceable>процент</replaceable></option></term> + <listitem><para> + Задает качество видео при перенаправлении как величина + от 10 до 100 процентов. Процент представляет уровень + сжатия JPEG, где меньшие значения ухудшают качество, + но обеспечивают более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-teleport"> + <title>Настройки портирования</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют настроить машину как цель + портирования. Смотрите <xref linkend="teleporting" />. + </para> + <variablelist> + <varlistentry> + <term><option>--teleporter=on | off</option></term> + <listitem><para> + Включает или выключает портирование. Когда включено, + машина стартует и ждет получения запроса на портирование + из сети вместо нормальной загрузки. + </para><para> + Запросы на портирование принимаются на порт и адрес, + указанный в следующих параметрах: + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-port=<replaceable>порт</replaceable></option></term> + <listitem><para> + Задает порт, который слушает ВМ для получения запросов + на портирование из другой ВМ. + <replaceable>порт</replaceable> - это любой свободный + номер TCP/IP порта, такой как <literal>6000</literal>. + Необходимо также указать опцию <option>--teleporter</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает IP адрес, который слушает ВМ для получения + запросов на портирование из другой ВМ. + <replaceable>IP-адрес</replaceable> - это любой IP + адрес или имя хоста. Он указывает сокет TCP/IP для + подключения. IP адрес по умолчанию + <literal>0.0.0.0</literal>, который представляет + любой IP адрес. Необходимо также указать опцию + <option>--teleporter</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-password=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Задает пароль, используемый для аутентификации. Когда + указан, запрос на портирование успешен только тогда, когда + пароль в исходной машине такой же, как и указанный. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-password-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает файл, содержащий пароль для использования в + аутентификации. Когда указан, запрос на портирование + успешен только тогда, когда пароль в исходной машине + такой же, как и в указанном файле. Значение + <literal>stdin</literal> читает пароль из стандартного + потока ввода. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-portability-level=<replaceable>уровень</replaceable></option></term> + <listitem> + <para> + Ограничивает способности виртуального ЦПУ, которые + &product-name; представляет гостевой ОС использую правила + портативности. Более высокие целые значения означают + более ограниченное поведение. Уровень по умолчанию + <literal>0</literal> показывает, что весь поддерживаемый + хостом вируализированный функционал доступен гостевой + системе. Значение <literal>3</literal> подавляет + большинство функций. Значения <literal>1</literal> + и <literal>2</literal> представляют ограничения между + предыдущими уровнями. Поведение может меняться в + зависимости от версии продукта. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-set=<replaceable>лист</replaceable>[:<replaceable>подлист</replaceable>] + <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></option></term> + <listitem> + <para> + Опытные пользователи используют эту настройку перед + операцией портирования (фактически перед запуском ВМ) + для ограничения способностей виртуального ЦПУ, которые + &product-name; предоставляет гостевой операционной + системе. Это должно быть запущено и на исходной и на + целевой машинах, вовлеченных в процесс портирования и + определяет, что гостевая система увидит когда выполняет + машинную инструкцию CPUID. Это может помочь с неправильным + поведением приложений, которые неправильно предполагают, + что присутствуют определенные способности ЦПУ. + Значение параметра зависит от оборудования. Обратитесь + к документации AMD или Intel. + </para><para> + Значения <replaceable>лист</replaceable>, + <replaceable>подлист</replaceable> (необязательно), + <replaceable>eax</replaceable>, <replaceable>ebx</replaceable>, + <replaceable>ecx</replaceable> и <replaceable>edx</replaceable> + - это целые числа данные в шестнадцатиричном формате, то есть + используя основание 16 без какого-либо префикса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-remove=<replaceable>лист</replaceable>[:<replaceable>подлист</replaceable>]</option></term> + <listitem> + <para> + Удаляет подстройку, установленную через <option>--cpuid-set</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-remove-all</option></term> + <listitem> + <para> + Удаляет все подстройки, установленные через <option>--cpuid-set</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-debugging"> + <title>Настройки отладки</title> + <remark role="help-copy-synopsis"/> + <para> + Используйте следующие опции только для низкоуровневой + отладки ВМ. Эти опции только для опытных пользователей. + </para> + <variablelist> + <varlistentry> + <term><option>--tracing-enabled=on | off</option></term> + <listitem><para> + Включает или отключает буфер трассировки. Заметим, что + когда указан, буфер трассировки потребляет память и + добавляет накладные расходы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-config=<replaceable>строка-настроек</replaceable></option></term> + <listitem><para> + Включает конфигурацию трассировки, определяющую группу + включенных точек трассировки. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-allow-vm-access=on | off</option></term> + <listitem><para> + Включает или отключает доступ ВМ к буферу трассировки. + Значение по умолчанию <literal>off</literal>, что + запрещает доступ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-usbcardreader"> + <title>Настройки USB картридера</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции задают доступ гостевого окружения к USB картридеру. + USB картридер может получить доступ к данным карт памяти, таких + как CompactFlash (CF), Secure Digital (SD) и MultiMediaCard (MMC). + </para> + <variablelist> + <varlistentry> + <term><option>--usb-card-reader=on | off</option></term> + <listitem><para> + Включает или отключает интерфейс USB картридера. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-autostart"> + <title>Автостарт ВМ в течение загрузки хост-системы</title> + <para> + Следующие опции позволяют настроить функцию автостарта ВМ, + которая автоматически стартует ВМ во время загрузки хост-системы. + Требуется произвести некоторые настройки хост-системы перед + использованием этой функции. Смотрите <xref linkend="autostart" />. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--autostart-enabled=on | off</option></term> + <listitem><para> + Включает или отключает автостарт ВМ во время загрузки + хост-системы для указанного пользователя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--autostart-delay=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает количество секунд, по истечении которых после + загрузки хост-системы, ВМ стартует. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-pcipassthrough"> + <title>Настройки сквозного режима PCI</title> + <para> + Следующие опции позволяют настроить функцию сквозного режима PCI, + которая на настоящий момент не доступна в &product-name;. + Планируется вернуть данный функционал в будущем. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--pci-attach=<replaceable>PCI-адрес-хоста</replaceable>[@<replaceable>гостевой-PCI-адрес-шины</replaceable>]</option></term> + <listitem><para> + Подключает указанный сетевой контроллер PCI хоста к гостевой + ВМ. Можно опционально указать шину PCI в гостевой ВМ, куда + подключать контроллер. +<!-- See <xref linkend="pcipassthrough" />. --> + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pci-detach=<replaceable>PCI-адрес-хоста</replaceable></option></term> + <listitem><para> + Отключает указанный сетевой контроллер PCI из + подключенной PCI шины гостевой ВМ. +<!-- See <xref linkend="pcipassthrough" />. --> + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-testing"> + <title>Тестирование (ValidationKit / Bootsector)</title> + <para> + Эти опции для настройки функционала тестирования VMM устройств и + почти экслюзивно используются bootsector тестами в ValidationKit. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--testing-enabled=on | off</option></term> + <listitem><para>Включен функционал тестирования VMMDev. Для подробной информации смотрите VMMDevTesting.h. </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--testing-mmio=on | off</option></term> + <listitem><para>Включена область MMIO для функционала тестирования VMMDev.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--testing-cfg-dword<replaceable>idx</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Это задает один из 10 DWORD значений конфигурации. + <replaceable>idx</replaceable> должен быть в диапазоне от 0 до 9. + <replaceable>значение</replaceable> ограничено 32 битами (DWORD). + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда изменяет описание для ВМ + <filename>ol7</filename>. + </para> +<screen>$ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4"</screen> + <para> + Следующая команда включает поддержку протокола удаленного + рабочего стола VirtualBox (VRDP) для ВМ <filename>ol7</filename>. + </para> +<screen>$ VBoxManage modifyvm ol7 --vrde on</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-showvminfo" />, + <xref linkend="vboxmanage-controlvm" />, + <xref linkend="vboxmanage-createvm" />, + <xref linkend="vboxmanage-startvm" /> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> |