Skip to main content

IMPORTANT - Product End of Life Statement - IMPORTANT

Request RE, Survey, and Calendar 1.5 Support Ending December 31, 2020
Contact Kinetic Data Support with Questions
Kinetic Community

VMWare VSphere Virtual Machine Power Off

Powers off the specified VMWare VSphere virtual machine. This simulates a hard reboot and does not attempt to safely shut down the guest operating system.


By downloading this file, you acknowledge that you agree to our Terms of Service

Detailed Description

poweroff_vmware.pngThis handler is designed to power off a virtual machine on a VMWare VSphere server that matches the name supplied to it.  It logs in to the VSphere server using the server's administrative URL, user ID and password that are set as info_value records for the task.  Once logged in, the virtual machine name is verified and then a signal is sent to it to power down the VM.  The VM responds with a signal stating that it is powering down and the handler exits.
This handler uses the VMWare VI (vSphere) Java API (see for more information).  The api is deployed as a Java archive file (jar) and is stored in this handler's vendor directory.  If the vijava jar file is stored somewhere else on the classpath, the jar file stored in this handler's vendor directory is not used.  It is recommended that there are no vijava jar files stored anywhere on the classpath, and that all ?VMWare VSphere handlers contain the same vijava jar file in their vendor directory.


Name Description
VM Name   The name of the VM that you want to power off.

Sample Configuration

Parameter Example Configuration
VM Name <%=@answers['VM Name']%>


This handler returns no results.

Change Log

Version Date Description
V1 2011-01-27 Initial Version