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:
The VM UUID or VM Name. Mandatory.
Name of the storage controller. Mandatory.
Define the type of the system bus to which the storage controller must be connected.
Allows to choose the type of chipset being emulated for the given storage controller.
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.
This determines how many ports the SATA controller should support.
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”.
Removes the storage controller from the VM config.