The Shut Down Guest OS for VM action shuts down the guest operating system and powers off the virtual machine. You shut down a virtual machine when you are managing resources and reclaiming wasted space.

The Shut Down Guest OS for VM action checks that VMware Tools, which is required, is installed on the target virtual machines, then shuts down the guest operating system and powers off the virtual machine. If VMware Tools is not installed or installed but not running, the action does not run and the job is reported as failed in Recent Tasks.

If the target virtual machine is already powered off, the recent task status reports success on the machine, even though the state of the virtual machine did not change.

For the supported objects and object levels, this action is available in the following locations in vRealize Operations Manager:

Center pane Action menu.

List toolbars, including Views on the Details tab, List on the Environments tab.

Resource List and Topology Graph dashboard widgets.

Environment Overview list. In the left pane, click the Administration icon, and click List.

Configured alert recommendations.

Review the following information about the virtual machines to ensure that you are submitting the action for the correct objects.

Option

Description

Selected objects

Check box indicates whether the action is applied to the object. If you do not want to run the action on one or more objects, deselect the associated check boxes. This option is available when two or more objects are selected.

Name

Name of the virtual machine as it appears in the environment inventory.

Power State

Indicates whether the virtual machine is powered on or powered off.

Idle VM

Indicates whether the virtual machine is considered to be in the idle state based on the configured idle virtual machine metric.

Possible values include:

false. The virtual machine is active.

true. The virtual machine is idle.

unknown. vRealize Operations Manager does not have the data required to calculate the idle metric.

Idle VM Percentage

Calculated threshold of the idle virtual machine percentage based on the configured reclaimable wasted space policy.

Host

Name of the host on which the virtual machine is running.

Adapter Instance

Name of the VMware Adapter as it is configured in vRealize Operations Manager. The adapter manages the communication with the vCenter Server instance.

After you click OK, the next dialog box provides the task ID and a link to the task list.

Task ID Dialog Box

Option

Description

Recent Tasks

To view the status of the job and verify that the job finished, click Recent Tasks.

OK

To close the dialog box without further action, click OK.