User manual VMWARE VIEW MANAGER 4.X EXTENDING VIRTUAL MACHINE DELECTION WITH SCRIPTS

[. . . ] Technical Note Extending Virtual Machine Deletion with Scripts View Manager 4. x When you delete a virtual machine from the VMware® ViewTM environment, you might want to run your own scripts to remove Active Directory or database entries that reference the deleted machine. This technical note describes how to configure View Manager to run such deletion scripts automatically when you delete a virtual machine. To enable a deletion script, you add an entry for the script to the Windows Registry, configure the account of the user who has the appropriate privileges to run the script, and enable the VMware View Script Host service. [. . . ] String that describes a problem that occurred while deleting the virtual machine. The following Visual Basic code fragment shows how to access the environment variable for the MAC address of the first network interface of a virtual machine that is being deleted. Dim shell set shell = WScript. CreateObject( "WScript. Shell" ) macAddr0 = shell. ExpandEnvironmentStrings("%VDM_DeleteVm_VmMac. 0%") VMware, Inc. 1 Extending Virtual Machine Deletion with Scripts The next example shows how you could extract the name of the virtual machine, and use this value to delete the corresponding entry from Active Directory. Dim shell set shell = WScript. CreateObject( "WScript. Shell" ) set vmName = shell. ExpandEnvironmentStrings("%VDM_DeleteVm_VmName%") set machineObj = GetObject("LDAP://CN=" & vmName & ", CN=Desktops, DC=MYDOMAIN, DC=COM") machineObj. DeleteObject(0) This example assumes that the script runs with the administrative rights to update entries in Active Directory. You must modify the script to correspond to the configuration of your local systems in Active Directory. Add a Windows Registry Entry for a Deletion Script To make a deletion script available for execution, you must add it to the Windows registry. You must create an entry on each View Connection Server instance where you want View Manager to run the deletion script when you delete a virtual machine. To add an entry for a deletion script to the registry on a View Connection Server instance 1 2 3 4 Start the Windows Registry Editor by entering regedit at the command prompt. In the registry, navigate to HKLM\SOFTWARE\VMware, Inc. \VMware VDM\ScriptEvents. In the navigation area, rightclick ScriptEvents, select New > Key, and create a key named DeleteVm. In the navigation area, rightclick DeleteVm, select New > String Value, and create a string value that identifies the deletion script to be run. To run more than one deletion script, create a string value entry for each script under the DeleteVm key. If the scripts must run in a specified order, invoke them from a single control script. 5 6 In the topic area, rightclick on the entry for the new string value, and select Modify. In Value data, enter the command line that invokes the deletion script, and click OK. Specify the full path of the deletion script and any files that it requires. 7 8 If you want the VMware View Script Host service to time out the deletion script, right click on the Default key, select Modify, enter the timeout value in milliseconds, and click OK. Exit the Registry Editor, and restart the system. Configure the VMware View Script Host Service You must configure the VMware View Script Host service on each View Connection Server instance where you want View Manager to run the deletion script. [. . . ] 3401 Hillview Ave. , Palo Alto, CA 94304 www. vmware. com Copyright © 2010 VMware, Inc. VMware products are covered by one or more patents listed at http://www. vmware. com/go/patents. All other marks and names mentioned herein may be trademarks of their respective companies. [. . . ]