Sun Microsystems VIRTUALBOX VERSION 3.1.0_BETA2 - Manual (Page 124)

8 VBoxManage reference
8.13.1 VBoxManage storagectl
This command attaches/modifies/removes a storage controller. The syntax is as fol-
lows:
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>]
[--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 con-
nected.
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 chapter 5.1 , Hard disk controllers: IDE, SATA (AHCI),
SCSI , page 76 , 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.
remove Removes the storage controller from the VM config.
8.13.2 VBoxManage storageattach
This command attaches/modifies/removes a storage medium connected to the storage
controller named by –storagectl. The syntax is as follows:
VBoxManage storageattach <uuid|vmname>
--storagectl <name>
--port <number>
--device <number>
[--type <dvddrive|hdd|fdd>
--medium <none|emptydrive|uuid|filename|host:<drive>>]
[--passthrough <on|off>]
[--forceunmount]
where the parameters mean:
uuid|vmname The VM UUID or VM Name. Mandatory.
124