Citrix Systems 6 User Manual

180

The  VM  or  VMs  on  which  this  operation  should  be  performed  are  selected  using  the  standard  selection
mechanism  (see 

).  Optional  arguments  can  be  any  number  of  the 

  listed  at  the

beginning of this section.

This  is  an  advanced  command  only  to  be  used  when  a  member  host  in  a  pool  goes  down.  You  can  use  this
command to force the pool master to reset the power-state of the VMs to be 

halted

. Essentially this forces the

lock on the VM and its disks so it can be subsequently started on another pool host. This call requires the force
flag to be specified, and fails if it is not on the command-line.

vm-resume

 [

<vm-selector>

=

<vm_selector_value>

...] [force=

<true | false>

] [on=

<XenServer host UUID>

]

Resume the specified VMs.

The  VM  or  VMs  on  which  this  operation  should  be  performed  are  selected  using  the  standard  selection
mechanism  (see 

).  Optional  arguments  can  be  any  number  of  the 

  listed  at  the

beginning of this section.

If the VM is on a shared SR in a pool of hosts, use the 

 argument to specify which host in the pool on which to

start it. By default the system will determine an appropriate host, which might be any of the members of the pool.

vm-shutdown

 [

<vm-selector>

=

<vm_selector_value>

...] [force=

<true | false>

]

Shut down the specified VM.

The  VM  or  VMs  on  which  this  operation  should  be  performed  are  selected  using  the  standard  selection
mechanism  (see 

).  Optional  arguments  can  be  any  number  of  the 

  listed  at  the

beginning of this section.

Use the 

 argument to cause an ungraceful shutdown, similar to pulling the plug on a physical server.

vm-start

  [

<vm-selector>

=

<vm_selector_value>

...]  [force=

<true  |  false>

]  [on=

<XenServer  host  UUID>

]  [--

multiple]

Start the specified VMs.

The  VM  or  VMs  on  which  this  operation  should  be  performed  are  selected  using  the  standard  selection
mechanism  (see 

).  Optional  arguments  can  be  any  number  of  the 

  listed  at  the

beginning of this section.

If the VMs are on a shared SR in a pool of hosts, use the 

 argument to specify which host in the pool on which

to start the VMs. By default the system will determine an appropriate host, which might be any of the members
of the pool.

vm-suspend

 [

<vm-selector>

=

<vm_selector_value>

...]

Suspend the specified VM.

The  VM  or  VMs  on  which  this  operation  should  be  performed  are  selected  using  the  standard  selection
mechanism  (see 

).  Optional  arguments  can  be  any  number  of  the 

  listed  at  the

beginning of this section.