Citrix Systems 5.6 manual Vm-disk-list, Vm-disk-remove, Vm-export, Vm-import

The disk-sizeparameter can be specified in bytes or using the IEC standard suffixes KiB (210 bytes), MiB (220 bytes), GiB (230 bytes), and TiB (240 bytes).

The VM or VMs on which this operation should be performed are selected using the standard selection mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the beginning of this section.

vm-disk-list

vm-disk-list[vbd-params] [vdi-params] [<vm-selector>=<vm_selector_value>...]

Lists disks attached to the specified VMs. The vbd-paramsand vdi-paramsparameters control the fields of the respective objects to output and should be given as a comma-separated list, or the special key all for the complete list.

The VM or VMs on which this operation should be performed are selected using the standard selection mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the beginning of this section.

vm-disk-remove

vm-disk-removedevice=<integer_label_of_disk> [<vm-selector>=<vm_selector_value>...]

Remove a disk from the specified VMs and destroy it.

The VM or VMs on which this operation should be performed are selected using the standard selection mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the beginning of this section.

vm-export

vm-exportfilename=<export_filename> [metadata=<true false>] [<vm-selector>=<vm_selector_value>...]

Export the specified VMs (including disk images) to a file on the local machine. Specify the filename to export the VM into using the filename parameter. By convention, the filename should have a .xva extension.

If the metadata parameter is true, then the disks are not exported, and only the VM metadata is written to the output file. This is intended to be used when the underlying storage is transferred through other mechanisms, and permits the VM information to be recreated (see the section called “vm-import”).

The VM or VMs on which this operation should be performed are selected using the standard selection mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the beginning of this section.

vm-import

vm-importfilename=<export_filename> [metadata=<true false>] [preserve=<true false>] [sr-uuid=<destination_sr_uuid>]

Import a VM from a previously-exported file. If preserve is set to true, the MAC address of the original VM will be preserved. The sr-uuiddetermines the destination SR to import the VM into, and is the default SR if not specified.

206