Sun Microsystems VERSION 3.1.0_BETA2 user manual VBoxManage storagectl, VBoxManage storageattach

8VBoxManage reference

8.13.1VBoxManage storagectl

This command attaches/modifies/removes a storage controller. The syntax is as fol- lows:

VBoxManage storagectl	<uuidvmname>
	--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:

uuidvmname 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	<uuidvmname>
	--storagectl <name>
	--port <number>
	--device <number>
	[--type <dvddrivehddfdd>
	--medium <noneemptydriveuuidfilenamehost:<drive>>]
	[--passthrough <onoff>]
	[--forceunmount]

where the parameters mean:

uuidvmname The VM UUID or VM Name. Mandatory.

124