|
|
|
|
path to .vmx
file
[
-noWait |
-activeWindow |
-interactive ]
program name
[
program
arguments ]
|
Runs a specified program
in the guest operating system. The
-noWait option returns a
prompt immediately after the program starts in the guest, rather than waiting
for it to finish. This option is useful for interactive programs. The
-activeWindow
option ensures that the Windows GUI is visible, not
minimized. It has no effect on Linux. The
-interactive option
forces interactive guest login. The option is useful for Windows Vista and
Windows 7 or later guests to make the program visible in the console window.
You must provide the full pathname of a program accessible to the guest. Also
provide fully accessible path names for any files specified in the program
arguments, according to the requirements of the program. VMware Tools and a
valid guest login are required.
|
|
|
Checks whether the
specified file exists in the guest operating system. VMware Tools and a valid
guest login are required.
|
|
path to .vmx
file
directory path on
guest
|
Checks whether the
specified directory exists in the guest operating system. VMware Tools and a
valid guest login are required.
|
|
path to .vmx
file
share name
path to folder on
host
writable |
readonly
|
Modifies the writability state of a specified
folder shared between the host and a guest virtual machine. The value for the
share name
parameter is a mount point in the guest file system. The value for the
path
to folder on host parameter is the exported directory on the
host. To make a shared folder writable or read-only, include the
writable or
readonly
parameter.
|
|
path to .vmx
file
share name
path to folder on
host
|
Adds a folder to be
shared between the host and guest. The virtual machine must be running for the
addSharedFolder option to
take effect. The value for the
share name
parameter is a mount point in the guest file system. The value for the
path
to folder on host parameter is the exported directory on the
host. On Windows guests, a delay might occur before shared folders are visible
to the
runProgramInGuest,
fileExistsInGuest, and
directoryExistsInGuest
options.
|
|
path to .vmx
file
share name
|
Removes the guest
virtual machine’s access to a shared folder on the host. The virtual machine
must be running for the
removeSharedFolder option
to take effect. The value for the
share name
parameter is a mount point in the guest file system.
|
|
path to .vmx
file
[runtime]
|
Allows the guest virtual
machine, specified by the
.vmx file, to share
folders with its host. After enabling, run the
addSharedFolder option to
specify each host folder to share. The optional
[runtime] argument limits the sharing of folders
until the virtual machine is powered off. Otherwise, the setting persists at
the next power-on.
Note
The
enableSharedFolders
option takes effect after the shut-down and restart of the guest. No error
message appears.
|
|
path to .vmx
file
[runtime]
|
Prevents the guest
virtual machine, specified by the
.vmx file, from
sharing folders with its host. The optional
[runtime] argument limits the stop applied to
the sharing of folders until the virtual machine is powered off. Otherwise, the
setting persists at next power on.
Note
The
disableSharedFolders
option takes effect after the shut-down and restart of the guest. No error
message appears.
|
|
|
Lists all processes
running in the guest operating system. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
process ID
|
Stops a specified
process in the guest operating system. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest. The process ID can be any number listed after
pid= in the output of the
listProcessesInGuest
option.
|
|
path to .vmx
file
[
-noWait |
-activeWindow |
-interactive ]
interpreter
path
script text
|
Runs the specified command script in the guest
operating system. See the
runProgramInGuest entry
for an explanation of options. The
interpreter
path option runs the script. Provide the complete text of
the script, not a filename. VMware Tools and a valid guest login are required.
For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
path to file on
guest
|
Deletes the given file
from the guest operating system. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
directory path on
guest
|
Creates the specified
directory in the guest operating system. VMware Tools and a valid guest login
are required. For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
directory path on
guest
|
Deletes the specified
directory from the guest operating system. VMware Tools and a valid guest login
are required. For example, you can use the
-gu
and
-gp
options to log in to the guest
|
|
|
Creates a temporary file
in the guest operating system, and returns the path name of the temporary file
created. The path name varies according to the operating system. You can run
the
deleteFileInGuest option
to remove the file. VMware Tools and a valid guest login are required. For
example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
directory path on
guest
|
Lists contents of the
specified directory in the guest operating system. VMware Tools and a valid
guest login are required. For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
file path on
host
file path in
guest
|
Copies a file from the
host to the guest operating system. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest. Specify the source filename, or host filename,
before the destination filename, or guest filename.
|
|
path to .vmx
file
file path in
guest
file path on
host
|
Copies a file from the
guest operating system to the host. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest. Specify the source filename, or guest filename,
before the destination filename, or host filename.
|
|
path to .vmx
file
original
filename
new filename
|
Renames or moves a file
in the guest operating system. VMware Tools and a valid guest login are
required. For example, you can use the
-gu
and
-gp
options to log in to the guest. Specify the source filename, or original
filename, before the destination filename.
|
|
path to .vmx
file
device name
|
Connects the device
named in the command to the guest operating system. You can only run this
command when the virtual machine is powered on. You can use device names, such
as
sound,
serial0,
Ethernet0,
sata0:1, etc.
Note
After you use the
vmrun
connectNamedDevice
command to connect a disconnected sound
device to a running virtual machine, powering off the virtual machine might
disconnect the sound device from the virtual machine, even though the virtual
machine settings list the sound device as connected.
|
|
path to .vmx
file
device name
|
Disconnects the device
named in the command from the guest operating system. You can only run this
command when the virtual machine is powered on. You can use device names, such
as
sound,
serial0,
Ethernet0,
sata0:1, etc.
Note
After you use the
vmrun
disconnectNamedDevice
command to disconnect a connected sound device from a running virtual machine,
powering off the virtual machine might reconnect the sound device to the
virtual machine, even though the virtual machine settings list the sound device
as disconnected.
|
|
path to .vmx
file
output path on
host
|
Captures the screen of
the virtual machine to a local file. The specified output file on the host is
in PNG format. A valid guest login is required. For example, you can use the
-gu
and
-gp
options to log in to the guest.
|
|
path to .vmx
file
[ guestVar |
runtimeConfig | guestEnv ]
variable name
variable value
|
Writes a variable to the virtual machine
state or guest. You can set a non‐persistent guest variable,
guestVar, a runtime
configuration variable,runtimeConfig, as stored
in the
.vmx file, or an
environment variable,
guestEnv, in the guest
operating system. A guest variable is a runtime‐only value that provides a
simple way to pass runtime values in and out of the guest. Environment
variables require VMware Tools and a valid guest login. For example, you can
use the
-gu
and
-gp
options to log in to the guest. With Linux, setting the guest environment also
requires root login.
|
|
path to .vmx
file
[ guestVar |
runtimeConfig | guestEnv ]
variable name
|
Reads a variable from the virtual machine
state or guest. You can get a guest variable, a runtime configuration as stored
in the
.vmx file, or
environment variables in the guest operating system. Reading the
guestEnv variable
requires a valid guest login. For example, you can use the
-gu
and
-gp
options to log in to the guest. See the
writeVariable entry for a
description of variable types.
|
|
path to .vmx
file
[ -wait ]
|
Retrieves the IP address of the guest.
When you use the
[ -wait
] option, the command waits until the IP address is available. For
example, the IP address is not available until the virtual machine powers on.
If the network is not ready, the command returns to the command-line prompt
immediately.
|