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>]
                            [--portcount <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.

--portcount

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.