<?xml version="1.0" encoding="UTF-8"?>
<!--
    manpage, user manual, usage: VBoxManage list
-->
<!--
    Copyright (C) 2006-2023 Oracle and/or its affiliates.

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

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

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

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

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

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

  <refnamediv>
    <refname>VBoxManage-list</refname>
    <refpurpose>просмотр системной информации и детали конфигурации ВМ</refpurpose>
    <refclass>&product-name;</refclass>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis id="synopsis-vboxmanage-list">
<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
      <command>VBoxManage list</command>
      <arg>--long</arg>
      <arg>--sorted</arg>
      <group>
        <arg choice="plain">bridgedifs</arg>
        <arg choice="plain">cloudnets</arg>
        <arg choice="plain">cloudprofiles</arg>
        <arg choice="plain">cloudproviders</arg>
        <arg choice="plain">cpu-profiles</arg>
        <arg choice="plain">dhcpservers</arg>
        <arg choice="plain">dvds</arg>
        <arg choice="plain">extpacks</arg>
        <arg choice="plain">floppies</arg>
        <arg choice="plain">groups</arg>
        <arg choice="plain">hddbackends</arg>
        <arg choice="plain">hdds</arg>
        <arg choice="plain">hostcpuids</arg>
        <arg choice="plain">hostdrives</arg>
        <arg choice="plain">hostdvds</arg>
        <arg choice="plain">hostfloppies</arg>
        <arg choice="plain">hostinfo</arg>
        <arg choice="plain">hostonlyifs</arg>
        <arg choice="plain">hostonlynets</arg>
        <arg choice="plain">intnets</arg>
        <arg choice="plain">natnets</arg>
        <arg choice="plain">ostypes</arg>
        <arg choice="plain">runningvms</arg>
        <arg choice="plain">screenshotformats</arg>
        <arg choice="plain">systemproperties</arg>
        <arg choice="plain">usbfilters</arg>
        <arg choice="plain">usbhost</arg>
        <arg choice="plain">vms</arg>
        <arg choice="plain">webcams</arg>
      </group>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Описание</title>
    <para>
      Подкоманды <command>VBoxManage list</command> позволяют получить
      информацию о ПО &product-name;, ВМ и соответствующих службах,
      созданных вами.
    </para>
    <refsect2 id="vboxmanage-list-common-options">
      <title>Общие настройки</title>
      <variablelist>
        <varlistentry>
          <term><option>--long</option></term>
          <listitem><para>
              Показывает детальную информацию по каждому элементу,
              если она доступна. Краткая форма этой опции:
              <option>-l</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--sorted</option></term>
          <listitem><para>
              Сортирует элементы детального списка по алфавиту.
              Краткая форма этой опции: <option>-s</option>.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-list-bridgedifs">
      <title>Отображение сетевых интерфейсов типа &quot;Сетевой мост&quot; в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-bridgedifs">
        <command>VBoxManage list</command>
        <arg choice="plain">bridgedifs</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list bridgedifs</command> отображает
        интерфейсы типа &quot;сетевой мост&quot;, доступные на данный момент
        в системе хоста. Вывод показывает детальную информацию о конфигурации
        каждого интерфейса. Смотрите <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-cloudnets">
      <title>Отображение облачных сетевых интерфейсов</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-cloudnets">
        <command>VBoxManage list</command>
        <arg choice="plain">cloudnets</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list cloudnets</command> отображает
        сконфигурированные облачные сетевые интерфейсы. Облачный сетевой
        интерфейс обеспечивает соединение между локальной ВМ и облачной
        сетью.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-cloudprofiles">
      <title>Отображение облачных профилей</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-cloudprofiles">
        <command>VBoxManage list</command>
        <arg choice="plain">cloudprofiles</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list cloudprofiles</command> отображает
        сконфигурированные облачные профили. Облачный профиль содержит
        настройки для учетной записи службы облака.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-cloudproviders">
      <title>Отображение облачных провайдеров</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-cloudproviders">
        <command>VBoxManage list</command>
        <arg choice="plain">cloudproviders</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list cloudproviders</command> показывает
        облачных провайдеров, поддерживаемых &product-name;.
        Примером облачного провайдера является Oracle Cloud Infrastructure.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-cpu-profiles">
      <title>Отображение известных профилей ЦПУ</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-cpu-profiles">
        <command>VBoxManage list</command>
        <arg choice="plain">cpu-profiles</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list cpu-profiles</command> отображает
        ЦПУ профили, известные в &product-name;.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-dhcpservers">
      <title>Отображение DHCP серверов в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-dhcpservers">
        <command>VBoxManage list</command>
        <arg choice="plain">dhcpservers</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list dhcpservers</command> отображает
        DHCP серверы, доступные в хост-системе. Вывод показывает
        детальную информацию о конфигурации каждого DHCP сервера.
        Смотрите <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-dvds">
      <title>Отображение образов виртуальных дисков DVD</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-dvds">
        <command>VBoxManage list</command>
        <arg choice="plain">dvds</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list dvds</command> отображает
        информацию об образах виртуальных дисков DVD, используемых
        в данный момент в ПО &product-name;. Для каждого образа
        вывод показывает все настройки, UUID, назначенные образу
        в &product-name; и все файлы связанные с образом.
      </para>
      <para>
        Эта команда выполняет ту же функцию, что и Менеджер виртуальных
        носителей. Смотрите <xref linkend="virtual-media-manager"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-extpacks">
      <title>Отображение установленных пакетов расширения &product-name;</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-extpacks">
        <command>VBoxManage list</command>
        <arg choice="plain">extpacks</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list extpacks</command> показывает
        все пакеты расширения &product-name;, установленные в системе
        на данный момент. Смотрите <xref linkend="intro-installing"/> и
        <xref linkend="vboxmanage-extpack"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-floppies">
      <title>Отображение образов виртуальных флоппи дисков</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-floppies">
        <command>VBoxManage list</command>
        <arg choice="plain">floppies</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list floppies</command> отображает
        информацию об образах флоппи дисков, используемых в &product-name;
        на данный момент. Для каждого образа вывод показывает все настройки,
        UUID, назначенные образу в &product-name; и все файлы связанные
        с образом.
      </para>
      <para>
        Эта команда выполняет ту же функцию, что и Менеджер виртуальных
        носителей. Смотрите <xref linkend="virtual-media-manager"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-groups">
      <title>Отображение групп виртуальных машин</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-groups">
        <command>VBoxManage list</command>
        <arg choice="plain">groups</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list groups</command> показывает
        все группы ВМ. Смотрите <xref linkend="gui-vmgroups"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hddbackends">
      <title>Отображение бэкендов виртуальных дисков</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hddbackends">
        <command>VBoxManage list</command>
        <arg choice="plain">hddbackends</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hddbackends</command> отображает
        все известные бэкенды виртуальных дисков ПО &product-name;
        Для каждого такого формата, таких как VDI, VMDK или RAW, эта
        команда показывает конфигурацию и возможности бэкенда.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hdds">
      <title>Отображение образов виртуальных жестких дисков</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hdds">
        <command>VBoxManage list</command>
        <arg choice="plain">hdds</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hdds</command> отображает
        информацию об образах виртуальных жестких дисков, которые
        используются ПО &product-name; на данный момент. Для каждого
        образа вывод показывает все настройки, UUID, назначенные образу
        в &product-name; и все файлы связанные с образом.
      </para>
      <para>
        Эта команда выполняет ту же функцию, что и Менеджер виртуальных
        носителей. Смотрите <xref linkend="virtual-media-manager"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostcpuids">
      <title>Отображение информации CPUID для ЦПУ хост-системы</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostcpuids">
        <command>VBoxManage list</command>
        <arg choice="plain">hostcpuids</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostcpuids</command> отображает
        информацию CPUID для каждого ЦПУ хост-системы. Используйте эту
        информацию для более тщательного анализа возможностей
        виртуализации в хост-системе.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostdrives">
      <title>Отображение дисков в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostdrives">
        <command>VBoxManage list</command>
        <arg choice="plain">hostdrives</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostdrives</command> отображает
        диски в хост-системе, потенциально полезные для создания образов
        VMDK raw дисков. Каждый элемент включает имя, используемое для
        ссылки на них из &product-name;.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostdvds">
      <title>Отображение DVD дисков в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostdvds">
        <command>VBoxManage list</command>
        <arg choice="plain">hostdvds</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostdvds</command> отображает
        DVD диски хост-системы. Каждый элемент включает имя, используемое
        для доступа к ним из &product-name;.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostfloppies">
      <title>Отображение флоппи дисков в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostfloppies">
        <command>VBoxManage list</command>
        <arg choice="plain">hostfloppies</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostfloppies</command>
        отображает флоппи диски в хост-системе. Каждый элемент
        включает имя, используемое для доступа к ним из &product-name;.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostinfo">
      <title>Отображение информации о хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostinfo">
        <command>VBoxManage list</command>
        <arg choice="plain">hostinfo</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostinfo</command> отображает
        информацию о хост-системе. Вывод включает информацию о ЦПУ,
        памяти и версии ОС.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostonlyifs">
      <title>Отображение сетевых интерфейсов виртуальной сети хоста</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostonlyifs">
        <command>VBoxManage list</command>
        <arg choice="plain">hostonlyifs</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostonlyifs</command> отображает
        интерфейсы виртуальной сети хоста, доступные в системе на данный
        момент. Вывод показывает детальную информацию о конфигурации
        каждого интерфейса. Смотрите <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-hostonlynets">
      <title>Отображение виртуальных сетей хоста</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-hostonlynets">
        <command>VBoxManage list</command>
        <arg choice="plain">hostonlynets</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list hostonlynets</command> отображает
        сконфигурированные виртуальные сети хоста. Виртуальная сеть хоста
        обеспечивает соединение между хостом и локальными ВМ. Смотрите
        <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-intnets">
      <title>Отображение внутренних сетей</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-intnets">
        <command>VBoxManage list</command>
        <arg choice="plain">intnets</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list intnets</command> показывает
        информацию о внутренних сетях. Смотрите
        <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-natnets">
      <title>Отображение интерфейсов сетей NAT в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-natnets">
        <command>VBoxManage list</command>
        <arg choice="plain">natnets</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list natnets</command> отображает
        интерфейсы сетей NAT, доступные в хост-системе на данный момент.
        Смотрите <xref linkend="networkingdetails"/>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-ostypes">
      <title>Отображение гостевых операционных систем</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-ostypes">
        <command>VBoxManage list</command>
        <arg choice="plain">ostypes</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list ostypes</command> отображает
        все гостевые операционные системы, известные ПО &product-name;.
        Каждый элемент включает идентификатор, описание, идентификатор
        семейства, описание семейства и имеет ли ОС 64 битную поддержку.
      </para>
      <para>
        Можно изспользовать эти идентификаторы с командой <command>VBoxManage
        modifyvm</command>.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-runningvms">
      <title>Отображение работающих виртуальных машин</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-runningvms">
        <command>VBoxManage list</command>
        <arg choice="plain">runningvms</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list runningvms</command> отображает
        все виртуальные машины (ВМ), работающие на данный момент. По
        умолчанию она показывает компактный список, содержащий имя и
        UUID каждой машины.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-screenshotformats">
      <title>Отображение доступных форматов снимков экрана</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-screenshotformats">
        <command>VBoxManage list</command>
        <arg choice="plain">screenshotformats</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list screenshotformats</command> показывает
        список доступных форматов снимков экрана.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-systemproperties">
      <title>Отображение системных свойств</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-systemproperties">
        <command>VBoxManage list</command>
        <arg choice="plain">systemproperties</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list systemproperties</command> показывает
        большую коллекцию глобальных настроек &product-name;
        и лимитов, таких как минимальный и максимальный размер RAM
        гостевой системы, размер виртуального жесткого диска, настройки
        папки и используемая в данный момент библиотека аутентификации.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-usbfilters">
      <title>Отображение зарегистрированных глобальных USB фильтров</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-usbfilters">
        <command>VBoxManage list</command>
        <arg choice="plain">usbfilters</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list usbfilters</command> отображает
        все глобальные USB фильтры зарегистрированные в &product-name;
        и показывает параметры фильтра. Глобальные USB фильтры - это
        фильтры для устройств, доступные всем виртуальным машинам.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-usbhost">
      <title>Отображение USB устройств в хост-системе</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-usbhost">
        <command>VBoxManage list</command>
        <arg choice="plain">usbhost</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list usbhost</command> отображает
        информацию об USB устройствах, подключенных к хост-системе.
        Вывод включает информацию, которую можно использовать для
        построения USB фильтров и показывает, используется ли
        устройство хост-системой на данный момент.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-vms">
      <title> Отображение виртуальных машин</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-vms">
        <command>VBoxManage list</command>
        <arg choice="plain">vms</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list vms</command> отображает
        все виртуальные машины (ВМ), зарегистрированные в &product-name;
        на данный момент. По умолчанию эта команда показывает компактный
        список, включающий имя и UUID каждой машины.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-list-webcams">
      <title>Отображение вебкамер, подключенных к работающей виртуальной машине</title>
      <cmdsynopsis id="synopsis-vboxmanage-list-webcams">
        <command>VBoxManage list</command>
        <arg choice="plain">webcams</arg>
      </cmdsynopsis>
      <para>
        Команда <command>VBoxManage list webcams</command> показывает
        список вебкамер, подключенных к работающей ВМ.
      </para>
      <para>
        Вывод состоит из списка абсолютных путей или псевдонимов,
        используемых для подключения вебкамер к ВМ, используя команду
        <command>VBoxManage webcam attach</command>.
      </para>
    </refsect2>
  </refsect1>

  <refsect1>
    <title>Примеры</title>
    <remark role="help-scope" condition="GLOBAL" />
    <para>
      Следующая команда показывает группы ВМ, сконфигурированные в
      &product-name;.
    </para>
<screen>$ VBoxManage list groups
"/Linux-VMs"
"/Windows-VMs"</screen>
    <para>
      Следующая команда показывает работающие на данный момент ВМ.
    </para>
<screen>$ VBoxManage list runningvms
"ol7" {<replaceable>ol7-UUID</replaceable>}
"win8" {<replaceable>win8-UUID</replaceable>}</screen>
  </refsect1>
</refentry>
