$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $

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