# VBoxManage import

VBoxManage-import

1

VBoxManage-import

импорт виртуальной конфигурации в формате OVF или из облачной службы и создание виртуальной машины

&product-name;

          VBoxManage import

            имя-ovf
            имя-ova

          --dry-run
          --options=
              keepallmacs
              keepnatmacs
              importtovdi

          --vsys=n
          --ostype=тип-ос
          --vmname=имя
          --settingsfile=файл
          --basefolder=папка
          --group=группа
          --memory=МБ
          --cpus=n
          --description=текст
          --eula=
              show
              accept

          --unit=n
          --ignore
          --scsitype=
              BusLogic
              LsiLogic

          --disk=путь

          VBoxManage import
          OCI://
          --cloud
          --ostype=тип-ос
          --vmname=имя
          --basefolder=папка
          --memory=МБ
          --cpus=n
          --description=текст
          --cloudprofile=профиль
          --cloudinstanceid=id
          --cloudbucket=корзина

## Описание

Команда `VBoxManage import` импортирует виртуальную конфигурацию из формата OVF или из облачной службы, например &oci;. Импорт производится путем копирования образов виртуальных дисков (по умолчанию в формает VMDK образа) и создания виртуальных машин (ВМ) в &product-name;. Смотрите ovf.

Необходимо указать путь к OVF файлу или OVA архиву в качестве входных данных или заполнитель для облачного варианта. В случае OVF конфигураций, убедитесь, что все образы дисков в той же директории, что и OVF файл.

Обратите внимание, что любые опции, указываемые для управления импортированной виртуальной конфигурацией или для изменения параметров импорта зависят от содержимого файла OVF или от информации из облачной службы.

Перед использованием операции импорта для создания ВМ, произведите пробный запуск для проверки корректности вашей конфигурации. Это полезно с конфигурациями OVF и OVA, потому что в случае с облачной службой, даже при пробном запуске необходимо произвести достаточно много действий, занимающих ощутимое время.

Импорт из облачной службы загружает временный файл, содержащий и загрузочный образ и некоторые метаданные, описывающие детали экземпляра ВМ. Временный файл удаляется после успешного импорта.

### Общие параметры

`имя-ovf` | `имя-ova`

- Задает имя файла OVF или архив OVA, описывающий конфигурацию. В случае облака, это обычно фиксированная строка, такая как `OCI://`.

`--dry-run`

- Производит пробный запуск команды `VBoxManage import` перед проведением реальной операции импорта. Операция пробного запуска делает следующее:

  - Выводит описание содержимого конфигурации, основанное на указанном OVF или OVA файле.

  - Показывает, как конфигурация могла быть импортирована в &product-name;. В дополнение, вывод показывает все опции, которые можно использовать для изменения поведения импорта.

  Краткая форма этой опции `-n`.

`--options=keepallmacs | keepnatmacs | importtovdi`

- Позволяет подстроить операцию импорта.

  Допустимые аргументы нижеследующие:

  - `keepallmacs`: Указывает, что MAC адреса каждой виртуальной сетевой карты остаются неизменными.

  - `keepnatmacs`: Указывает, что MAC адреса каждой виртуальной сетевой карты остаются неизменными если тип сети - NAT.

  - `importtovdi`: Указывает, что все новые образы дисков в формате файла VDI.

`--ostype=`тип-ос``

- Задает информацию о гостевой операционной системе (ОС) для ВМ. Используйте команду `VBoxManage list ostypes` для отображения идентификаторов типов ОС.

`--vmname=`имя``

- Задает имя ВМ в &product-name;.

`--basefolder=`папка``

- Задает папку, где сохраняются файлы импортированной ВМ.

`--memory=`МБ``

- Задает размер памяти в мегабайтах в импортированной ВМ.

`--cpus=`n``

- Задает количество ЦПУ в импортированной ВМ.

`--description=`текст``

- Задает текст описания, видимый в графическом и командном интерфейсе при проверке деталей ВМ.

### Опции импорта OVF / OVA

Следующие опции предназначены для импорта виртуальной конфигурации в форматах OVF или OVA. Такие конфигурации могут содержать один или несколько ВМ. Поэтому требуется указать, какую конфигурацию ВМ надо подстроить если вы хотите изменить ее. Смотрите ovf-import-appliance.

`--vsys=`n``

- Задает индекс конкретной ВМ внутри конфигурации. Влияет на нижеследующие опции.

`--unit=`n``

- Задает индекс конкретного элемента ВМ внутри конфигурации. Влияет на нижеследующие опции.

`--settingsfile=`файл``

- Задает имя файла настроек ВМ (с указанием пути или без), который будет создан как часть импорта. Обычно, более предпочтительный способ это переопределение имени ВМ через `--vmname` и, если нужно, указание папки, где надо создать ВМ, через `--basefolder`.

`--group=`группа``

- Задает первичную группу импортированной ВМ.

`--eula=show | accept`

- Позволяет вам отобразить или принять условия лицензии ВМ внутри конфигурации.

  Допустимы следующие аргументы:

  - `show`: Показывает лицензионное соглашение ВМ.

  - `accepts`: Принимает лицензионное соглашение ВМ. Все ВМ в конфигурации, имеющие лицензию, требуют ее принятия, иначе импорт закончится неудачей.

`--ignore`

- Игнорирует текущий элемент импортируемой ВМ, эффективно удаляя связанное аппаратное обеспечение.

`--scsitype=BusLogic | LsiLogic`

- Позволяет выбрать тип SCSI контроллера текущего элемента импортированной ВМ.

  Допустимы следующие аргументы:

  - `BusLogic`: Использует SCSI контроллер типа BusLogic (очень старый).

  - `LsiLogic`: Использует SCSI контроллер типа LsiLogic (более современный).

### Опции импорта из облака

Следующие опции предназначены для импорта экземпляра ВМ из провайдера облачной службы. Они всегда имеют дело только с одной ВМ. Смотрите cloud-import-oci.

`--cloud`

- Указывает, что импорт должен быть из облака.

`--cloudprofile=`профиль``

- Задает облачный профиль используемый для соединения с провайдером облачной службы. Облачный профиль содержит детали вашей учетной записи &oci;, такие как ваш OCID пользователя и отпечаток вашего публичного ключа. У вас должны быть требуемые права в &oci;, чтобы использовать облачный профиль.

`--cloudinstanceid=`id``

- Задает ID существующего экземпляра в облаке.

`--cloudbucket=`корзина``

- Задает имя корзины, куда сохранять объекты, созданные из экземпляра. В &oci;, корзина - это логический контейнер для сохранения объектов. По умолчанию, используется первая доступная корзина в облачном профиле.

## Примеры

Следующий пример производит пробный запуск операции OVF импорта примерной конфигурации, содержащей гостевую систему Windows 10:

    $ VBoxManage import Windows10.ovf --dry-run
    Интерпретация Windows10.ovf...
    OK.
    Виртуальная система 0:
     0: Предложенный тип ОС: "Windows10_64"
        (изменить через "--vsys 0 --ostype <тип>"; используйте "list ostypes" для просмотра всех возможных значений)
     1: Предложенное имя ВМ "win10-appliance"
        (изменить через "--vsys 0 --vmname <имя>")
     2: Предложенная группа ВМ "/"
        (изменить через "--vsys 0 --group <группа>")
     3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
        (изменить через "--vsys 0 --settingsfile <имя файла>")
     4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs"
        (изменить через "--vsys 0 --basefolder <путь>")
     5: Лицензионное соглашение
        (показать через "--vsys 0 --eula show";
        принять через "--vsys 0 --eula accept")
     6: Число ЦПУ: 1
        (изменить через "--vsys 0 --cpus <n>")
     7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory <MB>")
     8: Аудио карта (конфигурация ожидает "ensoniq1371", может быть изменена при импорте)
        (отключить через "--vsys 0 --unit 5 --ignore")
     9: USB контроллер
        (отключить через "--vsys 0 --unit 6 --ignore")
    10: Сетевой адаптер: ориг. сетевой мост, конфиг. 2, экстра тип=сетевой мост
    11: Флоппи
        (отключить через "--vsys 0 --unit 8 --ignore")
    12: SCSI контроллер, тип BusLogic
        (изменить через "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
        отключить через "--vsys 0 --unit 9 --ignore")
    13: IDE контроллер, тип PIIX4
        (отключить через "--vsys 0 --unit 10 --ignore")
    14: Образ жесткого диска: образ источника=Windows10.vmdk,
          путь назначения=/home/user1/disks/Windows10.vmdk, контроллер=9;канал=0
        (изменить путь назначения через "--vsys 0 --unit 11 --disk <путь>";
        отключить через "--vsys 0 --unit 11 --ignore")

Вывод пробного запуска показывает и нумерует индивидуальные элементы настройки описанные в файле `Windows10.ovf`. Некоторые из них включают информацию о том, как отключить или изменить настройку элемента.

Можно отключить многие элементы, используя опции `--vsys `X` --unit `Y` --ignore`. `X` - это номер виртуальной системы. Значение равно `0` если конфигурация содержит только одно описание виртуальной системы. `Y` - это номер элемента конфигурации.

Элемент 1 в выводе команды примера указывает имя целевой машины. Элементы 12 и 13 указывают контроллеры IDE и SCSI жестких дисков соответственно.

Элемент 14 показывает образ жесткого диска и опцию `--disk`, задающую путь назначения, где сохранять образ. Значение по умолчанию задается в файле OVF.

Можно комбинировать несколько элементов для той же самой виртуальной системы, путем указания того же самого значения для опции `--vsys`. Например, используйте следующую команду для импорта машины как описано в OVF, кроме аудио карты и USB контроллера, и образ диска должен сохраняться с другим именем.

    $ VBoxManage import Windows10.ovf --vsys 0 --unit 8 --ignore \
      --unit 9 --ignore --unit 14 --disk Windows10_disk0.vmdk

Следующий пример иллюстрирует как импортировать ВМ из &oci;. Для поиска экземпляров ВМ в &oci;, а также их ID, можно вывести список всех доступных экземпляров через:

    $ VBoxManage cloud --provider=OCI --profile=имя-облачного-профиля list instances

Когда ID известно, следующая команда импортирует экземпляр из &oci;:

    $ VBoxManage import OCI:// --cloud --vmname OCI_FreeBSD_VM --memory 4000 \
      --cpus 3 --ostype FreeBSD_64 --cloudprofile "standard user" \
      --cloudinstanceid ocid1.instance.oc1.iad.abuwc... --cloudbucket myBucket