Contents
Previous Next
Executing Scripts When the Virtual Machine's Power State Changes
Executing Scripts When the Virtual Machine's Power State Changes
You can run scripts in the guest operating system when you change the power state of a virtual machine; that is, when you power on, power off, suspend or resume the virtual machine.
Scripts can help automate guest operating system operations when you change the virtual machine's power state.
You perform these power operations from the toolbar buttons and menus in the VMware Virtual Machine Console and the VMware Management Interface.
You can configure scripts to run automatically when you use the power buttons on the toolbar by choosing VM > Settings > Options > Power, then checking the appropriate options under Run VMware Tools scripts.
Note: The commands on the Power menu take precedence over how the toolbar power buttons are configured.
Scripts can be executed only when the VMware Tools service is running. The service is a part of VMware Tools, so VMware Tools must be running in the guest in order for scripts to run. The service starts by default when you start the guest operating system. For more information about the VMware Tools service, see
About the VMware Tools Service.
Default scripts are included in VMware Tools. On a Windows host, the default script executed when you suspend a virtual machine releases the IP address of the virtual machine, while the default script executed when you resume a virtual machine renews the IP address of the virtual machine (this affects only virtual machines configured to use DHCP). On a Linux host, the default script executed when you suspend a virtual machine stops networking for the virtual machine, while the default script executed when you resume a virtual machine starts networking for the virtual machine.
In addition, you can create your own scripts. The scripts you can run must be batch files for Windows hosts, but can be any executable format (such as shell or Perl scripts) for Linux hosts. You should have a thorough familiarity with these types of scripts before you modify the default scripts or create your own.
In order for scripts and their associated power operations to work, the following conditions must be met:
1. The VMware Tools service must be running in the virtual machine.
2. The version of VMware Tools must be updated to the current version. If you are using a virtual machine created with an older version of GSX Server or another older VMware product, update VMware Tools to the version included in this release.
3. Depending upon the operation the script performs, the virtual machine must have a virtual network adapter connected, otherwise the power operation fails.
Issues to Consider
Caution: When you reinstall VMware Tools after you upgrade the GSX Server software, any changes you made to the default scripts are overwritten. Any scripts you created on your own remain untouched, but do not benefit from any underlying changes that enhance the default scripts.
Note: Scripts cannot be run in NetWare, FreeBSD and Windows 95 guest operating systems.