Citrix Systems 6 ユーザーズマニュアル

160

vdi-uuid=

<uuid_of_the_vdi_the_vbd_will_connect_to>

 [bootable=true] [type=

<Disk | CD>

] [mode=

<RW | RO>

]

Create a new VBD on a VM.

Appropriate values for the 

 field are listed in the parameter 

 on the specified

VM. Before any VBDs exist there, the allowable values are integers from 0-15.

If the 

 is 

, 

 is required. Mode can be 

 or 

 for a Disk.

If the 

 is 

, 

 is optional; if no VDI is specified, an empty VBD will be created for the CD. Mode

must be 

 for a CD.

vbd-destroy

 uuid=

<uuid_of_vbd>

Destroy the specified VBD.

If the VBD has its 

 parameter set to 

, the associated VDI will also be destroyed.

vbd-eject

 uuid=

<uuid_of_vbd>

Remove the media from the drive represented by a VBD. This command only works if the media is of a removable
type (a physical CD or an ISO); otherwise an error message 

VBD_NOT_REMOVABLE_MEDIA

 is returned.

vbd-insert

 uuid=

<uuid_of_vbd>

 vdi-uuid=

<uuid_of_vdi_containing_media>

Insert new media into the drive represented by a VBD. This command only works if the media is of a removable
type (a physical CD or an ISO); otherwise an error message 

VBD_NOT_REMOVABLE_MEDIA

 is returned.

vbd-plug

 uuid=

<uuid_of_vbd>

Attempt to attach the VBD while the VM is in the running state.

vbd-unplug

 uuid=

<uuid_of_vbd>

Attempts to detach the VBD from the VM while it is in the running state.

Commands for working with VDIs (Virtual Disk Images).

A VDI is a software object that represents the contents of the virtual disk seen by a VM, as opposed to the VBD,
which is a connector object that ties a VM to the VDI. The VDI has the information on the physical attributes of the
virtual disk (which type of SR, whether the disk is shareable, whether the media is read/write or read only, and so
on), while the VBD has the attributes which tie the VDI to the VM (is it bootable, its read/write metrics, and so on).