Reference Guide › AutoShell › AutoShell Loadable Modules' Command Reference › CA VMware vCenter Server AutoShell Commands › dpmvc-cycle Command--Cycle a VM (Funclet)

dpmvc-cycle Command--Cycle a VM (Funclet)

The dpmvc-cycle command powers on, powers off, resets, or suspends a VM.

This command has the following format:

dpmvc-cycle 
-powerop {poweron|poweroff|reset|suspend|shutdown guest} 
{-datacenter_name datacentername | -vc vcenterservername}
-vm_name vmname 

-powerop {poweron|poweroff|reset|suspend|shutdown guest}

Specifies the power operation to perform on the VM. Options include the following:

poweron

Powers on the VM.

poweroff

Powers off the VM.

reset

Resets the VM.

suspend

Temporarily suspends the VM.

shutdown guest

Shuts down the guest OS gracefully.

-datacenter_name datacentername

Specifies the data center where the VM is located.

-vc vcenterservername

Specifies the vCenter Server where the VM is located.

-vm_name vmname

Specifies the VM.

Example: Turn off a VM when there are Multiple vCenter Servers in the Data Center

This example powers off a VM from a specific vCenter Server.

dpmvc-cycle -powerop poweroff -vc my_server1 -vm_name my_vm

Example: Turn on a VM in Single vCenter Server Environment

This example powers off the VM, "testvm" that belongs to the data center "VAS/MyCity."

dpmvc-cycle -vm_name testvm -powerop poweron -datacenter_name VAS/MyCity