VMware Guest - Copy File

Declaration

<AMVMWAREGUEST HOSTTYPE="Server" SERVER="text" USERNAME="text" 
PASSWORD="text (options)" VMPATH="text" GUESTUSERNAME="text" 
CONSOLE="YES/NO" LAUNCHGUI="YES/NO" TIMEOUT="number" 
GUESTPASSWORD="text (options)" OPENVMTIMEOUT="number" 
POWERONTIMEOUT="number" TOOLSTIMEOUT="number" 
LOGINTIMEOUT="number" CONNECTIONTIMEOUT="number" 
COPYFROM="text (options)" GUESTFILE="text" 
HOSTFILE="text" />

Description

Copies a file or directory from the guest operating system to the local system or copies a file or directory from the local system to the guest operating system.

NOTE: All functions that execute in a guest operating system require VMware Tools to be installed and running. Additionally, a valid guest login is required to run this activity.

Practical Usage

Used to copy a file or folder to or from the guest OS. The format of the file name depends on the operating system. For example, a path name for a Microsoft Windows guest or host requires backslash as a directory separator, whereas a Linux guest or host requires a forward slash. If the path name includes backslash characters, you need to precede each one with an escape character.

Connection Parameters

Property

Type

Required

Default

Markup

Description

Connection

 

 

 

 

Indicates where connection details, guest credentials and other preferences should originate from. This is a visual mode parameter used only during task construction and configuration, thus, comprises no markup. The available options are:The available options are:

  • Host (Default) - Connection details, guest credentials and other preferences are configured individually for this activity. Select this option if only a single activity is required to complete an operation.

  • Session - Connection details, guest credentials and other preferences are obtained from a session created in a previous step with the use of the WMware Guest - Connect activity. Select this option if a combination of activities within the same action group are required to complete an operation. Linking several activities to a single session eliminates redundancy and improves efficiency. Several sessions can exist in a single task. Multiple sessions can run simultaneously without interference.

Session

Text

Yes if Connection set to Session

GuestOSOpsSession1

SESSION="MySession"

The name of an existing session to associate this activity with. This parameter is available only if the Connection parameter is set to Session.

Host type

Text (options)

Yes if Connection set to Host

VMWare VI Server

  1. HOSTTYPE="Server"

  2. HOSTTYPE="Workstation"

  3. HOSTTYPE="VIServer"

  4. HOSTTYPE="Player"

Indicates the VMware software type running on the host where the virtual machine is located. If you are using VMware Server to connect to a remote host, it does not matter which VMware product (if any) is running on the local host. This parameter is available only if the Connection parameter is set to Host. The available options are:

  • VMWare Server (1.0x)

  • VMWare Workstation

  • VMWare VI Server (ESX/ESXi, vCenter, VMWare Server 2.0)

  • VMWare Player

Host name

Text

Yes

(Empty)

  1. SERVER="host.server.com"

  2. SERVER="xxx.xxx.xxx.xxx"

The host name or IP address of the computer where the virtual machine is located. This parameter is active only if the Host type parameter is set to VMWare Server (1.0x) or VMWare VI Server (ESX/ESXi, vCenter, VMWare Server 2.0).

[Host] Username

Text

Yes

(Empty)

USERNAME="theUser"

The username identifying a valid user account on the virtual machine. This parameter is active only if the Host type parameter is set to VMWare Server (1.0x) or VMWare VI Server (ESX/ESXi, vCenter, VMWare Server 2.0).

[Host] Password

Text

Yes

(Empty)

PASSWORD="encrypted"

The password identifying a valid user account on the virtual machine. This parameter is active only if the Host type parameter is set to VMWare Server (1.0x) or VMWare VI Server (ESX/ESXi, vCenter, VMWare Server 2.0).

Virtual machine path

Text

Yes

(Empty)

VMPATH=

"c:\My Virtual Machines\vm_name.vmx"

The path to the virtual machine. (Example: c:\My Virtual Machines\virtual_machine_name.vmx).

[Guest] Username

Text

Yes

(Empty)

GUESTUSERNAME="user"

The username to authenticate the guest user.

[Guest] Password

Text

Yes

(Empty)

GUESTPASSWORD="encrypted"

The password to authenticate the guest user.

Log onto console session

Yes/No

No

No

CONSOLE="yes"

If set to YES, the user will be logged onto the console session. This parameter is set to NO by default.

Launch GUI

Yes/No

No

No

LAUNCHGUI="yes"

If set to YES, a GUI (Graphic User Interface) will appear on the desktop upon connection. If set to NO (default), no GUI will be launched and operations will execute in the background.

Open VM timeout

Number

No

60

OPENVMTIMEOUT="2"

The maximum time period in seconds during which this activity must be completed or the step times out. The default value is 60 seconds.

Power on timeout

Number

No

60

POWERONTIMEOUT="3"

The maximum time period in seconds during which the VM must power on or the step times out. The default value is 60 seconds.

VMware tools timeout

Number

No

300

TOOLSTIMEOUT="4"

The maximum time period in seconds during which VMWare Tools must start on the guest operating system or the step times out. The default value is 300 seconds.

Log on timeout

Number

No

60

LOGINTIMEOUT="5"

The maximum time period in seconds during which the log on process must be completed or the step times out. The default value is 60 seconds.

Connection timeout

Number

No

60

CONNECTIONTIMEOUT="6"

The maximum time period in seconds during which a connection must be established or the step times out. The default value is 60 seconds.

Guest OS Operations Parameters

Property

Type

Required

Default

Markup

Description

Copy file from

Text (options)

Yes

Host to Guest

  1. COPYFROM="guest_to_host"

  2. COPYFROM="guest_to_host"

Indicates where the file or directory to copy originates from and where it should be copied to. The available options are:

  • Host to guest (default) - The file/directory will be copied from the host machine to the guest machine.

  • Guest to host - The file/directory will be copied from the guest machine to the host machine.

Host/Guest file path

Text

Yes

(Empty)

  1. HOSTFILE="C:\foldername\filename.jpg"

  2. GUESTFILE="C:\foldername\filename.jpg"

The path and filename of the file or directory you wish to copy. If the Copy file from parameter is set to the option Host to guest, this parameter indicates Host file path. If the Copy file from parameter is set to the option Guest to host, this parameter indicates Guest file path.

NOTE: The format of the file name depends on the operating system.

Host/Guest file path

Text

Yes

(Empty)

  1. GUESTFILE="C:\foldername\filename.jpg"

  2. HOSTFILE="C:\foldername\filename.jpg"

The path and file name in which to copy the file/directory to. If the Copy file from parameter is set to the option Host to guest, this parameter indicates Guest file path. If the Copy file from parameter is set to the option Guest to host, this parameter indicates Host file path.

NOTE: The format of the file name depends on the operating system.

Timeout (seconds)

Number

No

(Empty)

TIMEOUT="20"

The maximum time period in seconds during which this activity must be completed or the step times out.

Example

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: This task uses several VMware Guest OS activities. It creates a session using the Connect activity, logs onto the guest VMware using the Login activity, and checks if a specific guest file exists on the host using the File Exists activity. If the guest file exists, it is copied over to the host machine using the Copy activity. The task ends with a Disconnect step. Comments are included in the task to explain each step.

<AMVARIABLE NAME="myVar">lt;/AMVARIABLE>
<!-- Create a guest session. -->
<AMVMWAREGUEST ACTIVITY="connect" 
HOSTTYPE="Workstation" 
VMPATH="C:\Users\Username\Documents\Virtual 
Machines\Windows Server 2008 x86\Windows Server 2008 (experimental).vmx" 
GUESTUSERNAME="Techsupport" 
GUESTPASSWORD="AM1ag7WmWg7U1xbulaHHhbEOLvMrSDiPrC4aME" 
CONSOLE="yes" LAUNCHGUI="yes" OPENVMTIMEOUT="90" 
POWERONTIMEOUT="90" />
<!-- Log onto guest. -->
<AMVMWAREGUEST ACTIVITY="login" 
LOGINUSERNAME="Techsupport" 
LOGINPASSWORD="AM1ag7WmWg7U1xbulaHHhbEOLvMrSDiPrC4aME" 
LOGINCONSOLE="yes" TIMEOUT="3000" />
<!-- Check if a specific guest file exists.  -->
<AMVMWAREGUEST ACTIVITY="file_exists" 
GUESTFILE="C:\Users\techsupport\Desktop\hello.txt" 
RESULTVARIABLE="myVar"  />
<!-- If guest file exists, copy it over to the host machine. -->
<AMIF EXPRESSION="%myVar% = True">
<AMVMWAREGUEST COPYFROM="guest_to_host" 
GUESTFILE="C:\Users\techsupport\Desktop\hello.txt" 
HOSTFILE="C:\Users\techsupport\Desktop\hello.txt" />
</AMIF>
<!-- Close Connection -->
<AMVMWAREGUEST ACTIVITY="disconnect" />