Citrix Systems 5.6 User Manual

203

vm-cd-insert

 cd-name=

<name_of_cd>

 [

<vm-selector>

=

<vm_selector_value>

...]

Insert a CD into the virtual CD drive. This command will only work if there is one and only one empty CD

device attached to the VM. When there are two or more empty CD devices, use the 

xe vbd-insert command

and specify the UUIDs of the VBD and of the VDI to insert.

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-cd-list

 [vbd-params] [vdi-params] [

<vm-selector>

=

<vm_selector_value>

...]

Lists CDs attached to the specified VMs.

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.

You can also select which VBD and VDI parameters to list.

vm-cd-remove

 cd-name=

<name_of_cd>

 [

<vm-selector>

=

<vm_selector_value>

...]

Remove a virtual CD from the specified VMs.

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-clone

 new-name-label=

<name_for_clone>

[new-name-description=

<description_for_clone>

] [

<vm-selector>

=

<vm_selector_value>

...]

Clone an existing VM, using storage-level fast disk clone operation where available. Specify the name

and  the  optional  description  for  the  resulting  cloned  VM  using  the 

  and 

 arguments.

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-compute-maximum-memory

 total=

<amount_of_available_physical_ram_in_bytes>

[approximate=

<add overhead memory for additional vCPUS? true | false>

]

[

<vm_selector>

=

<vm_selector_value>

...]

Calculate the maximum amount of static memory which can be allocated to an existing VM, using the total

amount of physical RAM as an upper bound. The optional parameter 

 reserves sufficient

extra memory in the calculation to account for adding extra vCPUs into the VM at a later date.