Name

Description

$err = VMSuspend($vmHandle,
                 $powerOffOptions);

This function suspends a virtual machine.

Parameters

vmHandle

Identifies a virtual machine. Call VMOpen() to create a virtual machine handle.

powerOffOptions

Should be 0.

Return Value

Remarks

• This function suspends a virtual machine.
• If the virtual machine is not powered on when you call this function, the function returns the error VIX_E_VM_NOT_RUNNING.
• Call VMPowerOn to resume running a suspended virtual machine.

Side Effects

Requirements

use VMware::Vix::Simple;
use VMware::Vix::API::Constants;

Example

my $err = VIX_OK;
my $hostHandle = VIX_INVALID_HANDLE;
my $vmHandle = VIX_INVALID_HANDLE;

($err, $hostHandle) = HostConnect(VIX_API_VERSION,
                                  VIX_SERVICEPROVIDER_VMWARE_VI_SERVER,
                                  "https://10.1.9.245/sdk", # hostName
                                  0, # hostPort
                                  "root", # userName
                                  "secret", # password
                                  0, # options
                                  VIX_INVALID_HANDLE); # propertyListHandle

die "HostConnect() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

($err, $vmHandle) = VMOpen($hostHandle,
                           "[storage1] vm/vm.vmx");
die "VMOpen() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;
                       
# Assume this virtual machine is already running
$err = VMSuspend($vmHandle,
                  0); # powerOffOptions
die "VMPowerOff() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;