To complete a restore, the calling process requires the permissions in Required permissions to complete a restore.

Table 1. Required permissions to complete a restore
Privilege Category Privilege Subcategory Privilege
Virtual Machine Inventory Create
Remove
Configuration Settings
Change Resource
Resource Assign Virtual Machine to Resource Pool

For security reasons, programs are not granted write access to the disks of a running virtual machine. Before you shut it down, you should determine the run-state of the virtual machine.

Run-state information is available from the PropertyCollector, and if you keep this information up-to-date, your application already knows the run-state of the virtual machine. To change the run-state you must have the moRef of the virtual machine. Use this moRef in a PowerOnVM_Task call through the server connection. For virtual machine shutdown, call the PowerOffVM_Task method.