Name

Description

$err = VMRunScriptInGuest($vmHandle,
                          $interpreter,
                          $scriptText,
                          $options,
                          $propertyListHandle);

This function runs a script in the guest operating system.

Parameters

vmHandle

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

interpreter

The path to the script interpreter, or NULL to use cmd.exe as the interpreter on Windows.

scriptText

The text of the script.

options

Run options for the program. See the remarks below.

propertyListHandle

Must be VIX_INVALID_HANDLE.

Return Value

Remarks

• This function runs the script in the guest operating system.
• The current working directory for the script executed in the guest is not defined. Absolute paths should be used for files in the guest, including the path to the interpreter, and any files referenced in the script text.
• You must call VMLoginInGuest() before calling this function.
• If the options parameter is 0, this function will return when the program exits in the guest operating system. Alternatively, you can pass VIX_RUNPROGRAM_RETURN_IMMEDIATELY as the value of the options parameter, and this function

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_WORKSTATION,
                                  undef, # hostName
                                  0, # hostPort
                                  undef, # userName
                                  undef, # password
                                  0, # options
                                  VIX_INVALID_HANDLE); # propertyListHandle

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

($err, $vmHandle) = VMOpen($hostHandle,
                           "c:\\Virtual Machines\\vm1\\win2000.vmx");
die "VMOpen() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;
                       
$err = VMPowerOn($vmHandle,
                 0, # powerOnOptions
                 VIX_INVALID_HANDLE);  # propertyListHandle
die "VMPowerOn() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;


$err = VMWaitForToolsInGuest($vmHandle,
                             300); # timeoutInSeconds
die "VMWaitForToolsInGuest() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

$err = VMLoginInGuest($vmHandle,
                      "vixuser", # userName
                      "secret", # password
                      0); # options
die "VMLoginInGuest() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

#
#  Perl script to reverse the lines in a file
#
my $scripttext = 
"if (!open IN, \"<\", \"in.txt\") { die \"failed to open input file\"};\n" .
"if (!open OUT, \">\", \"out.txt\") { die \"failed to open output file\"};\n" .
"@input = <IN>;\n" .
"@reverse = reverse @input;\n" .
"print OUT @reverse;\n";

# Run the target program.
$err =  VMRunScriptInGuest($vmHandle,
			   "c:\\perl\\perl.exe",
			   $scripttext,
			   0, # options
			   VIX_INVALID_HANDLE);
die "VMRunScriptInGuest() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

ReleaseHandle($vmHandle);
HostDisconnect($hostHandle);