<?xml version="1.0" encoding="UTF-8"?>
<!--
    manpage, user manual, usage: VBoxManage getextradata
-->
<!--
    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-getextradata" lang="en">
  <refentryinfo>
    <pubdate>$Date: 2023-01-18 00:40:56 +0100 (Wed, 18 Jan 2023) $</pubdate>
    <title>VBoxManage getextradata</title>
  </refentryinfo>

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

  <refnamediv>
    <refname>VBoxManage-getextradata</refname>
    <refpurpose>просмотр значений ключей, связанных с виртуальной машиной или конфигурацией</refpurpose>
    <refclass>&product-name;</refclass>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis id="synopsis-vboxmanage-getextradata">
<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
      <command>VBoxManage getextradata</command>
      <group choice="req">
        <arg choice="plain">global</arg>
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <group choice="plain">
        <arg choice="req"><replaceable>ключ</replaceable></arg>
        <arg>enumerate</arg>
      </group>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Описание</title>
    <para>
      Команда <command>VBoxManage getextradata</command> позволяет получить
      данные ключа, связанного с виртуальной машиной (ВМ) или с конфигурацией
      &product-name;.
    </para>
    <variablelist>
      <varlistentry>
        <term><literal>global</literal></term>
        <listitem><para>
            Указывает, что надо получить информацию из конфигурации,
            а не из ВМ.
          </para></listitem>
      </varlistentry>
      <varlistentry>
        <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term>
        <listitem><para>
            Указывает Универсальный Уникальный Идентификатор (UUID) или
            имя ВМ.
          </para></listitem>
      </varlistentry>
      <varlistentry>
        <term><literal>enumerate</literal></term>
        <listitem><para>
            Показывает все значения ключей для указанной ВМ
            или конфигурации.
          </para></listitem>
      </varlistentry>
      <varlistentry>
        <term><replaceable>ключ</replaceable></term>
        <listitem><para>
            Задает ключ, данные которого надо получить.
          </para></listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Примеры</title>
    <remark role="help-scope" condition="GLOBAL"/>
    <para>
      Следующая команда получает значение ключа <literal>installdate</literal>
      для ВМ <literal>Fedora5</literal>:
    </para>
<screen>$ VBoxManage getextradata Fedora5 installdate
VirtualBox Command Line Management Interface Version <replaceable>номер-версии</replaceable>
Copyright (C) 2005-2023 Oracle and/or its affiliates

Значение: 2006.01.01</screen>
    <para>
      Следующая команда получает информацию для всех ключей ВМ
      <literal>OracleLinux7u4</literal>:
    </para>
<screen>$ VBoxManage getextradata OracleLinux7u4 enumerate
Ключ: GUI/LastCloseAction, Значение: PowerOff
Ключ: GUI/LastGuestSizeHint, Значение: 1048,696
Ключ: GUI/LastNormalWindowPosition, Значение: 851,286,1048,738</screen>
    <para>
      Следующая команда получает информацию для всех ключей в
      конфигурации:
    </para>
<screen>$ VBoxManage getextradata global enumerate
Ключ: GUI/Details/Elements, Значение: general,system,preview,display,storage,audio,network,usb,sharedFolders,description
Ключ: GUI/DetailsPageBoxes, Значение: general,system,preview,display,storage,audio,network,usb,sharedFolders,description
Ключ: GUI/GroupDefinitions/, Значение: m=43349dd8-2aa3-41b8-988f-0e255ce68090,m=9ebcd81e-5231-48ce-a27d-28218757f3fe,m=c690e8b1-93a0-4c95-9cd7-6437fff93251,m=f7c1e10d-3722-4891-887e-07b3c4104946
Ключ: GUI/HideDescriptionForWizards, Значение: NewVM
Ключ: GUI/LastItemSelected, Значение: m=ol7u4
Ключ: GUI/LastWindowPosition, Значение: 951,510,960,520
Ключ: GUI/RecentFolderCD, Значение: C:/Users/user1
Ключ: GUI/RecentListCD, Значение: C:\Users\user1\V1.iso,C:\Users\user1\V2.iso,C:\Users\user1\V3.iso
Ключ: GUI/SplitterSizes, Значение: 318,637
Ключ: GUI/SuppressMessages, Значение: remindAboutMouseIntegration,remindAboutAutoCapture
Ключ: GUI/Toolbar/MachineTools/Order, Значение: Details
Ключ: GUI/Tools/LastItemsSelected, Значение: Welcome,Details
Ключ: GUI/UpdateCheckCount, Значение: 71
Ключ: GUI/UpdateDate, Значение: 1 d, 2019-04-10, stable, 5.2.22
Ключ: GUI/VirtualMediaManager/Details/Expanded, Значение: true</screen>
  </refsect1>

  <refsect1>
    <title>Смотрите также</title>
    <para>
      <xref linkend="vboxmanage-setextradata" />
    </para>
  </refsect1>
</refentry>
