8.19. VBoxManage storagectl

This command attaches/modifies/removes a storage controller. After this, virtual media can be attached to the controller with the storageattach command (see the next section).

The syntax is as follows:

VBoxManage storagectl       <uuid|vmname>
                            --name <name>
                            [--add <ide/sata/scsi/floppy>]
                            [--controller <LsiLogic|LSILogicSAS|BusLogic|
                                          IntelAhci|PIIX3|PIIX4|ICH6|I82078>]
                            [--sataportcount <1-30>]
                            [--hostiocache on|off]
                            [--bootable on|off]
                            [--remove]

where the parameters mean:

uuid|vmname

The VM UUID or VM Name. Mandatory.

name

Name of the storage controller. Mandatory.

add

Define the type of the system bus to which the storage controller must be connected.

controller

Allows to choose the type of chipset being emulated for the given storage controller.

sataportcount

This determines how many ports the SATA controller should support.

hostiocache

Configures the use of the host I/O cache for all disk images attached to this storage controller. For details, please see Section 5.7, “Host I/O caching”.

bootable

Selects whether this controller is bootable.

remove

Removes the storage controller from the VM config.