Skip to main content
Kinetic Community

VMWare VSphere Virtual Machine Shutdown

Resets the specified VMWare VSphere virtual machine. This simulates a hard power off followed by an automatic power on 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

shutdown_vmware.pngThis handler is designed to shut down 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 go through the shut down process. The VM responds with a signal stating that the shutdown process has begun 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 shut down

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