8.17. 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/BusLogic/IntelAhci/PIIX3/
                                           PIIX4/ICH6/I8207>]
                            [--sataideemulation<1-4> <1-30>]
                            [--sataportcount <1-30>]
                            [--hostiocache 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.

sataideemulation

This specifies which SATA ports should operate in IDE emulation mode. As explained in Section 5.1, “Hard disk controllers: IDE, SATA (AHCI), SCSI, SAS”, by default, this is the case for SATA ports 1-4; with this command, you can map four IDE channels to any of the 30 supported SATA ports.

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”.

remove

Removes the storage controller from the VM config.