# VBoxManage sharedfolder

VBoxManage-sharedfolder

1

VBoxManage-sharedfolder

добавление или удаление общих папок

&product-name;

          VBoxManage sharedfolder add

            uuid
            имя-ВМ

          --name=имя
          --hostpath=путь-в-хост-системе
          --readonly
          --transient
          --automount
          --auto-mount-point=путь

          VBoxManage sharedfolder remove

            uuid
            имя-ВМ

          --name=имя
          --transient

## Описание

Общие папки позволяют предоставить совместный доступ к данным между хост-системой и гостевыми системами. Для использования общих папок, сначала надо установить Дополнения Гостевой ОС &product-name; в гостевой ОС.

Общая папка связана с именем разделяемого ресурса и полным путем к папке или директории в хост-системе. Имя разделяемого ресурса - это уникальное имя в пространстве имен ОС хоста.

### Добавить общую папку

Команда `VBoxManage sharedfolder add` создает общую папку. Папка указывается в хост-системе. Когда папка настроена, к содержимому папки в хост-системе может быть предоставлен совместный доступ в гостевых ОС.

`uuid`|`имя-ВМ`

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

--name=`имя`

- Задает имя разделяемого ресурса, который имеет уникальное имя в пространстве имен ОС хоста.

--hostpath=`путь-в-хост-системе`

- Задает абсолютный путь к папке или директории в ОС хоста для предоставления доступа гостевым ОС.

--readonly

- Указывает, что разделяемый ресурс имеет доступ только для чтения к файлам хоста.

  По умолчанию, общие папки имеют доступ на чтение и на запись к файлам хоста. Однако, в дистрибутивах Linux, общие папки монтируются с файловыми разрешениями 770, пользователем `root` и группой `vboxsf`. Эта опция устанавливает файловые разрешения в 700.

--transient

- Задает что разделяемый ресурс временный, что означает, что он может быть добавлен и удален в время выполнения и не сохраняется после выключения ВМ.

--automount

- Указывает, что разделяемый ресурс монтируется автоматически.

--auto-mount-point=`путь`

- Задает точку монтирования разделяемого ресурса. Зависит от гостевой ОС.

  Для гостевых систем Windows и OS/2 она должна быть неиспользуемой буквой диска. Если оставить пустым (или указать используемую букву диска), будет использована последняя неиспользуемая буква диска вместо указанной (то есть ищется буква с `Z:` по `A:`).

  Для Linux, Solaris и других гостевых систем UNIX, он должен быть абсолютным путем, например `/mnt/mysharedfolder`. Если оставить пустым, расположение по умолчанию будет `/media/sf_`имя-общей-папки``.

### Удалить общую папку

Команда `VBoxManage sharedfolder remove` удаляет общую папку.

`uuid`|`имя-ВМ`

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

--name=`имя`

- Задает имя удаляемого разделяемого ресурса.

--transient

- Указывает, что папка временная, что означает что она может быть добавлена и удалена во время выполнения и не сохраняется после выключения ВМ.

## Примеры

Следующая команда создает общую папку, называемую `o7share` для ВМ `ol7`. Папка монтируется автоматически при старте ВМ.

    $ VBoxManage sharedfolder add ol7 --name ol7share --hostpath "/home/user/ol7share" --automount

Следующая команда удаляет общую папку, называемую `o7share` из ВМ `ol7`.

    $ VBoxManage sharedfolder remove ol7 --name ol7share