7.18. VBoxManage storagectl

This command attaches, modifies, and removes a storage controller. After this, virtual media can be attached to the controller with the storageattach command.

The syntax for this command 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]

The parameters are as follows:

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. See Section 5.7, “Host Input/Output 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 configuration.