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.