Skip to main content
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.

Downloads

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

vmware_vsphere_virtualmachine_poweroff_v1.zip

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 http://vijava.sourceforge.net/ 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.

Parameters

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']%>

Results

This handler returns no results.

Change Log

Version Date Description
V1 2011-01-27 Initial Version