VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-encryptmedium.xml@ 103068

Last change on this file since 103068 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 8.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage encryptmedium
4-->
5<!--
6 Copyright (C) 2006-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-encryptmedium" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage encryptmedium</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-encryptmedium</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-encryptmedium</refname>
44 <refpurpose>управляет образом или носителем, зашифрованными DEK</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-encryptmedium">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage encryptmedium</command>
52 <group choice="req">
53 <arg choice="plain"><replaceable>uuid</replaceable></arg>
54 <arg choice="plain"><replaceable>имя-файла</replaceable></arg>
55 </group>
56 <arg>--cipher=<replaceable>ID-шифра</replaceable></arg>
57 <arg>--newpassword=<replaceable>пароль</replaceable></arg>
58 <arg>--newpasswordid=<replaceable>ID-пароля</replaceable></arg>
59 <arg>--oldpassword=<replaceable>пароль</replaceable></arg>
60 </cmdsynopsis>
61 </refsynopsisdiv>
62
63 <refsect1>
64 <title>Описание</title>
65 <para>
66 Команда <command>VBoxManage encryptmedium</command> позволяет
67 создавать или управлять образом или носителем, зашифрованными DEK.
68 Можно зашифровать образ, расшифровать образ, изменить пароль
69 шифрования образа. Смотрите <xref linkend="diskencryption-encryption" />.
70 </para>
71 <variablelist>
72 <varlistentry>
73 <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term>
74 <listitem><para>
75 Задает Универсальный Уникальный Идентификатор (UUID) или
76 абсолютный путь шифруемого носителя или образа.
77 </para></listitem>
78 </varlistentry>
79 <varlistentry>
80 <term><option>--newpassword=<replaceable>пароль</replaceable></option></term>
81 <listitem><para>
82 Задает новый пароль шифрования. <replaceable>пароль</replaceable>
83 - это или абсолютный путь к файлу с паролем в хост-системе
84 или <literal>-</literal>. Во втором случае будет предложено
85 ввести пароль.
86 </para><para>
87 Необходимо использовать опцию <option>--newpasswordid</option>
88 вместе с этой опцией <option>--newpassword</option>.
89 </para></listitem>
90 </varlistentry>
91 <varlistentry>
92 <term><option>--oldpassword=<replaceable>пароль</replaceable></option></term>
93 <listitem><para>
94 Задает исходный пароль шифрования. <replaceable>пароль</replaceable>
95 - это или абсолютный путь к файлу с паролем в хост-системе
96 или <literal>-</literal>. Во втором случае будет предложено
97 ввести пароль.
98 </para><para>
99 Эта опция позволяет получить доступ к зашифрованному
100 носителю или образу, чтобы произвести следующее:
101 </para><itemizedlist>
102 <listitem><para>
103 Расшифровать зашифрованный образ используя эту опцию.
104 </para></listitem>
105 <listitem><para>
106 Изменить пароль зашифрованного образа используя опцию
107 <option>--newpassword</option>.
108 </para></listitem>
109 <listitem><para>
110 Изменить шифр образа используя опцию
111 <option>--cipher</option>.
112 </para></listitem>
113 </itemizedlist></listitem>
114 </varlistentry>
115 <varlistentry>
116 <term><option>--cipher=<replaceable>ID-шифра</replaceable></option></term>
117 <listitem><para>
118 Указывает шифр для шифрования. Допустимые значения
119 <literal>AES-XTS128-PLAIN64</literal> или
120 <literal>AES-XTS256-PLAIN64</literal>.
121 </para><para>
122 Эта опция позволяет установить или изменить шифрование
123 носителя или образа.
124 </para></listitem>
125 </varlistentry>
126 <varlistentry>
127 <term><option>--newpasswordid=<replaceable>ID-пароля</replaceable></option></term>
128 <listitem><para>
129 Указывает новый идентификатор пароля, используемого для
130 корректной идентификации, когда передаются несколько паролей
131 во время старта ВМ.
132 </para><para>
133 Если вы используете одни и те же пароль и идентификатор
134 пароля при шифровании нескольких образов то вам достаточно
135 указать пароль один раз во время старта ВМ.
136 </para></listitem>
137 </varlistentry>
138 </variablelist>
139 </refsect1>
140
141 <refsect1>
142 <title>Примеры</title>
143 <remark role="help-scope" condition="GLOBAL"/>
144 <para>
145 Следующий пример показывает как зашифровать образ
146 <filename>ol7u4-1.vdi</filename>, используя шифр
147 <literal>AES-XTS128-PLAIN64</literal>, задавая идентификатор
148 пароля <literal>1001</literal> и используя файл пароля
149 <filename>$HOME/pwfile</filename>:
150 </para>
151<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" \
152 --cipher="AES-XTS128-PLAIN64" --newpasswordid="1001" --newpassword=$HOME/pwfile</screen>
153 <para>
154 Следующий пример показывает как расшифровать зашифрованный образ
155 называемый <filename>ol7u4-2.vdi</filename>:
156 </para>
157<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-2.vdi" \
158 --oldpassword=-
159 Пароль: <replaceable>исходный-пароль</replaceable></screen>
160 <para>
161 Следующий пример показывает как изменить пароль зашифрованного
162 образа называемого <filename>ol7u4-3.vdi</filename>. Команда
163 читает исходный пароль из файла <filename>$HOME/pwfile.orig</filename>
164 и назначает идентификатор пароля <literal>1001</literal>.
165 </para>
166<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-3.vdi" \
167 --oldpassword=$HOME/pwfile.orig --newpassword=$HOME/pwfile --newpasswordid="1001"</screen>
168 </refsect1>
169</refentry>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette