8 VBoxManage [--forceunmount] [--server name|ip] [--target target] [--port port] [--lun lun] [--encodedlun lun] [--username username] [--password password] [--intnet] A number of parameters are commonly required the ones at the end of the list are required only for iSCSI targets (see below). The common parameters are: uuid|vmname The VM UUID or VM Name. Mandatory. storagectl Name of the storage controller. Mandatory. The list of the storage controllers cur- rently attached to a VM can be obtained with VBoxManage showvminfo see chapter 8.4, VBoxManage showvminfo, page 107. port The number of the storage controller’s port which is to be modified. Mandatory. device The number of the port’s device which is to be modified. Mandatory. type Define the type of the drive to which the medium is being attached/detached/modified. This argument can only be omitted if the type of medium can be determined from either the medium given with the --medium argument or from a previous medium attachment. medium Specifies what is to be attached. The following values are supported: • “none”: Any existing device should be removed from the given slot. • “emptydrive”: For a virtual DVD or floppy drive only, this makes the device slot be- haves like a removeable drive into which no media has been inserted. • If a UUID is specified, it must be the UUID of a storage medium that is already known to VirtualBox (e.g. because it has been attached to another virtual machine). See chapter 8.3, VBoxManage list, page 106 for how to list known media. This medium is then attached to the given device slot. • If a filename is specified, it must be the full path of an existing disk image (ISO, RAW, VDI, VMDK or other), which is then attached to the given device slot. • “host:drive“: For a virtual DVD or floppy drive only, this connects the given device slot to the specified DVD or floppy drive on the host computer. • “iscsi”: For virtual hard disks only, this allows for specifying an iSCSI target. In this case, more parameters must be given see below. Some of the above changes, in particular for removeable media (floppies and CDs/DVDs), can be effected while a VM is running. Others (device changes or changes in hard disk device slots) require the VM to be powered off. mtype Defines how this medium behaves with respect to snapshots and write operations. See chapter 5.4, Special image write modes, page 76 for details. comment Any description that you want to have stored with this medium (optional for exam- ple, for an iSCSI target, “Big storage server downstairs”). This is purely descriptive and not needed for the medium to function correctly. passthrough For a virtual DVD drive only, you can enable DVD writing support (currently ex- perimental see chapter 5.9, CD/DVD support, page 81). 120