12.0

Option Parameters Description
connectNamedDevice 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.
disconnectNamedDevice 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.
captureScreen 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.
writeVariable 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.
readVariable 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.
getGuestIPAddress 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.
Using VMware Fusion
VMware, Inc. 199