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|sas|usb|pcie]
[--controller LSILogic|LSILogicSAS|BusLogic|
IntelAhci|PIIX3|PIIX4|ICH6|I82078|
USB|NVMe]
[--portcount <1-30>]
[--hostiocache on|off]
[--bootable on|off]
[--rename <name>]
[--remove]
where the parameters mean:
-
uuid|vmname -
The VM UUID or VM Name. Mandatory.
-
--name -
Specifies the name of the storage controller. Mandatory.
-
--add -
Specifies the type of the system bus to which the storage controller must be connected.
-
--controller -
Enables a choice of chipset type being emulated for the given storage controller.
-
--portcount -
This specifies the number of ports the storage 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 -
Specifies whether this controller is bootable.
-
--rename -
Specifies a new name for the storage controller.
-
--remove -
Removes the storage controller from the VM config.