Change State activity

The Change State activity sends commands to vCenter to control the power state of a given VMware virtual machine, such as powering on and powering off the VM.

If the VM is already in the state to which it is being changed, the workflow takes no action.

These variables determine the behavior of the activity.

Table 1. Input variables
Field Description
vCenter IP address to the vCenter server that manages the virtual machine to operate.
Action Select the new state for the virtual machine:
  • Power On: turns on a virtual machine that is powered off or suspended and does nothing if the virtual machine is already on.
  • Power Off: turns off a virtual machine that is powered on or suspended and does nothing if the virtual machine is already off. This variable returns an error if the virtual machine is suspended.
  • Suspend: suspends a virtual machine that is powered on and does nothing if the virtual machine is already suspended. This variable returns an error if the virtual machine is off.
  • Reset: resets a virtual machine that is powered on. This variable returns an error if the virtual machine is off or suspended.
VM uuid The VMware universal unique identifier assigned to this virtual machine. The Virtual Machine UUID topic provides instructions on properly formatting the unique identifier for creating a workflow.