salt.states.vbox_guest¶

VirtualBox Guest Additions installer state

salt.states.vbox_guest.additions_installed(name, reboot=False, upgrade_os=False)¶

Ensure that the VirtualBox Guest Additions are installed. Uses the CD, connected by VirtualBox.

name

The name has no functional value and is only used as a tracking reference.

rebootFalse

Restart OS to complete installation.

upgrade_osFalse

Upgrade OS (to ensure the latests version of kernel and developer tools installed).

salt.states.vbox_guest.additions_removed(name, force=False)¶

Ensure that the VirtualBox Guest Additions are removed. Uses the CD, connected by VirtualBox.

To connect VirtualBox Guest Additions via VirtualBox graphical interface press 'Host+D' ('Host' is usually 'Right Ctrl').

name

The name has no functional value and is only used as a tracking reference.

force

Force VirtualBox Guest Additions removing.

salt.states.vbox_guest.grant_access_to_shared_folders_to(name, users=None)¶

Grant access to auto-mounted shared folders to the users.

User is specified by its name. To grant access for several users use argument users.

name

Name of the user to grant access to auto-mounted shared folders to.

users

List of names of users to grant access to auto-mounted shared folders to. If specified, name will not be taken into account.