Los comandos vmrun se dividen en categorías de funciones.

Las siguientes tablas describen los comandos vmrun y los parámetros para Fusion según su función. Los parámetros se describen uno por línea. Los parámetros entre corchetes son opcionales. La barra vertical indica una opción de palabra clave.

Parámetros y comandos de encendido y apagado de vmrun

Opción Parámetros Descripción
start

ruta al archivo .vmx

[ gui | nogui ]

Inicia una máquina virtual. La opción predeterminada gui inicia la máquina de forma interactiva, lo cual es necesario para mostrar la interfaz de Fusion. La opción nogui suprime la interfaz de Fusion, incluyendo el cuadro de diálogo de inicio, para permitir la creación de scripts no interactiva.
Nota: Para iniciar máquinas virtuales cifradas, use la marca nogui. La utilidad vmrun no admite el modo de interfaz gráfica de usuario con máquinas virtuales cifradas.
stop

ruta al archivo .vmx

[ hard | soft ]

Detiene una máquina virtual. Use la opción soft para apagar el invitado después de ejecutar los scripts de apagado. Use la opción hard para apagar el invitado sin ejecutar scripts, como si presionara el botón de encendido y apagado. El valor predeterminado es usar el valor powerType especificado en el archivo .vmx, si está presente.

reset

ruta al archivo .vmx

[ hard | soft ]

Restablece una máquina virtual. Use la opción soft para ejecutar scripts de apagado antes de reiniciar el invitado. Use la opción hard para reiniciar el invitado sin ejecutar scripts, como si presionara el botón de restablecer. El valor predeterminado es usar el valor powerType especificado en el archivo .vmx, si está presente.

suspend

ruta al archivo .vmx

[ hard | soft ]

Suspende una máquina virtual sin apagar la máquina virtual, por lo que el trabajo local puede reanudarse más tarde. La opción soft suspende el invitado después de ejecutar los scripts del sistema. En invitados de Windows, estos scripts liberan la dirección IP. En invitados de Linux, los scripts suspenden las redes. La opción hard suspende el invitado sin ejecutar los scripts. El valor predeterminado es usar el valor powerType especificado en el archivo .vmx, si está presente.

Para reanudar las operaciones de máquina virtual después de que el comando suspend finalice, use el comando start. En Windows, se obtiene la dirección IP. En Linux, se reinician las redes.

pause

ruta al archivo .vmx

Pone en pausa una máquina virtual.

unpause

ruta al archivo .vmx

Reanuda las operaciones de una máquina virtual desde el punto donde se detuvo el operación normal.

Parámetros y comandos de instantánea de vmrun

Opción Parámetros Descripción
listSnapshots

ruta al archivo .vmx

[ showtree ]

Enumera todas las instantáneas de una máquina virtual. La opción showtree muestra las instantáneas en formato de árbol, con elementos secundarios listados bajo su elemento principal.

snapshot

ruta al archivo .vmx

nombre de la instantánea

Crea una instantánea de una máquina virtual. Dado que Fusion admite varias instantáneas, debe proporcionar el nombre de la instantánea.

Dado que la barra diagonal define los nombres de ruta, no use el carácter de barra diagonal en un nombre de instantánea. De lo contrario, posteriormente resulta complicado especificar la ruta de la instantánea.

deleteSnapshot

ruta al archivo .vmx

nombre de la instantánea

[ andDeleteChildren ]

Quita una instantánea de una máquina virtual. Dado que Fusion admite varias instantáneas, debe proporcionar el nombre de la instantánea. La máquina virtual debe estar apagada o suspendida. Si la instantánea tiene elementos secundarios, se convierten en elementos secundarios del elemento principal de la instantánea eliminada y las instantáneas posteriores continúan como antes, desde el final de la cadena.

La opción andDeleteChildren elimina la instantánea especificada y su elementos secundarios de forma recurrente.

Consulte revertToSnapshot para obtener soluciones para los conflictos de nombre.
revertToSnapshot

ruta al archivo .vmx

nombre de la instantánea

o

ruta al archivo .vmx

Instantánea/"Instantánea 2"/"Instantánea N"

Establece la máquina virtual a su estado en tiempo de instantánea. Sin embargo si la máquina virtual se encendió en el momento de la instantánea, vmrun la revierte al estado de suspensión, pero no reanuda la ejecución de la máquina virtual.

Si una instantánea tiene un nombre único dentro de una máquina virtual, revierta a esa instantánea especificando la ruta al archivo de configuración de la máquina virtual y el nombre de instantánea único.

Si varias instantáneas tienen el mismo nombre, especifique la instantánea mediante la inclusión de un nombre de ruta completo para la instantánea. Un nombre de ruta es una serie de nombres de instantánea, separados por caracteres de barra diagonal (/). Cada nombre especifica una nueva instantánea en el árbol. Por ejemplo, el nombre de ruta Instantánea1/Instantánea2 identifica una instantánea con el nombre Instantánea2 tomada a partir del estado de una instantánea con el nombre Instantánea1.

Parámetros y comandos del adaptador de red de vmrun

Solo Fusion Pro admite los comandos del adaptador de red.

Opción Parámetros Descripción
listNetworkAdapters

ruta al archivo .vmx

Enumera los adaptadores de red en una máquina virtual.

addNetworkAdapter

ruta al archivo .vmx

Tipo de adaptador de red

[ Host nework ]

Agrega un adaptador de red a una máquina virtual.

Nota: El tipo de adaptador de red puede ser nat, hostOnly, bridged o custom. Cuando el adaptador de red es nat, hostOnly o bridged, no se requiere el parámetro Host nework. Solo cuando el tipo de adaptador de red es custom, debe especificar un valor para el parámetro Host nework. Por ejemplo, vmrun addNetworkAdapter el archivo .vmx custom vmnet3.

Debe designar una red virtual personalizada con uno de los nombres que aparecen en la sección Personalizado del panel de configuración de red de la máquina virtual o en el panel de preferencias de red de Fusion.

.
setNetworkAdapter

ruta al archivo .vmx

Índice de adaptador de red

Tipo de adaptador de red

[ Host nework ]

Actualiza un adaptador de red en una máquina virtual.

Nota: El tipo de adaptador de red puede ser nat, hostOnly, bridged o custom. Cuando el adaptador de red es nat, hostOnly o bridged, no se requiere el parámetro Host nework. Solo cuando el tipo de adaptador de red es custom, debe especificar un valor para el parámetro Host nework. Por ejemplo, vmrun addNetworkAdapter el archivo .vmx custom vmnet3.

Debe designar una red virtual personalizada con uno de los nombres que aparecen en la sección Personalizado del panel de configuración de red de la máquina virtual o en el panel de preferencias de red de Fusion.

deleteNetworkAdapter

ruta al archivo .vmx

Índice de adaptador de red

Elimina un adaptador de red de una máquina virtual.

Parámetros y comandos de red de host de vmrun

Solo Fusion Pro admite los comandos de red de host.

Opción Parámetros Descripción
listHostNetworks

Enumera todas las redes en el host.

listPortForwardings

nombre de red de host

Enumera todos los enrutamientos de puerto disponibles en una red de host.

setPortForwarding

nombre de red de host

protocolo

puerto de host

ip de invitado

puerto del invitado

[Description]

Establece un enrutamiento de puerto en una red de host.

Nota: Para evitar que el comando devuelva un error, use la utilidad sudo con esta opción. Por ejemplo, sudo vmrun setPortForwarding.
deletePortForwarding

nombre de red de host

protocolo

puerto de host

Elimina un enrutamiento de puerto en una red de host.

Nota: Para evitar que el comando devuelva un error, use la utilidad sudo con esta opción. Por ejemplo, sudo vmrun deletePortForwarding.

Parámetros y comandos de sistema operativo invitado de vmrun

El tiempo de espera, que es la espera de VMware Tools, es de cinco minutos para todos los comandos relacionados con el invitado.

Opción Parámetros Descripción
runProgramInGuest

ruta al archivo .vmx

[ -noWait | -activeWindow | -interactive ]

nombre del programa

[ argumentos del programa ]

Ejecuta un programa especificado en el sistema operativo invitado. La opción -noWait devuelve un mensaje inmediatamente después de que se inicie el programa en el invitado, en lugar de esperar a que finalice. Esta opción es útil para los programas interactivos. La opción -activeWindow garantiza que la interfaz gráfica de usuario de Windows está visible, no minimizada. No tiene ningún efecto en Linux. La opción -interactive obliga a realizar un inicio de sesión de invitado interactivo. La opción es útil para invitados de Windows Vista, Windows 7 o versiones posteriores para que el programa sea visible en la ventana de la consola. Debe proporcionar la ruta completa de un programa accesible para el invitado. Proporcione también los nombres de ruta totalmente accesible para los archivos especificados en los argumentos del programa, según los requisitos del programa. Se requiere VMware Tools y un inicio de sesión de invitado válido.

fileExistsInGuest

ruta al archivo .vmx

Comprueba si el archivo especificado existe en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido.

directoryExistsInGuest

ruta al archivo .vmx

ruta de directorio en el invitado

Comprueba si el directorio especificado existe en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido.

setSharedFolderState

ruta al archivo .vmx

nombre del recurso compartido

ruta a la carpeta en el host

writable | readonly

Modifica el estado de escritura de una carpeta especificada compartida entre el host y una máquina virtual invitada. El valor del parámetro de nombre de recurso compartido es un punto de montaje en el sistema de archivos invitado. El valor del parámetro de ruta a la carpeta en el host es el directorio exportado en el host. Para hacer que una carpeta compartida sea grabable o de solo lectura, incluya el parámetro writable o readonly.
addSharedFolder

ruta al archivo .vmx

nombre del recurso compartido

ruta a la carpeta en el host

Agrega una carpeta para compartir entre el host y el invitado. La máquina virtual debe estar en ejecución para que la opción addSharedFolder tenga efecto. El valor del parámetro de nombre de recurso compartido es un punto de montaje en el sistema de archivos invitado. El valor del parámetro de ruta a la carpeta en el host es el directorio exportado en el host. En invitados de Windows, puede producirse un retraso antes de que las carpetas compartidas estén visibles para las opciones runProgramInGuest, fileExistsInGuest y directoryExistsInGuest.

removeSharedFolder

ruta al archivo .vmx

nombre del recurso compartido

Elimina el acceso de la máquina virtual invitada a una carpeta compartida en el host. La máquina virtual debe estar en ejecución para que la opción removeSharedFolder tenga efecto. El valor del parámetro de nombre de recurso compartido es un punto de montaje en el sistema de archivos invitado.

enableSharedFolders

ruta al archivo .vmx

[runtime]

Permite que la máquina virtual invitada, especificada por el archivo .vmx, comparta carpetas con su host. Después de la habilitación, ejecute la opción addSharedFolder para especificar cada carpeta de host para compartir. El argumento [runtime] opcional limita el uso compartido de carpetas hasta que se apague la máquina virtual. De lo contrario, la configuración se conserva durante el encendido siguiente.
Nota: La opción enableSharedFolders se aplicará después de la conclusión y el reinicio del invitado. No se muestra ningún mensaje de error.
disableSharedFolders

ruta al archivo .vmx

[runtime]

Evita que la máquina virtual invitada, especificada por el archivo .vmx, comparta carpetas con su host. El argumento [runtime] opcional limita la detención aplicada al uso compartido de carpetas hasta que se apague la máquina virtual. De lo contrario, la configuración se conserva durante el encendido siguiente.
Nota: La opción disableSharedFolders se aplicará después de la conclusión y el reinicio del invitado. No se muestra ningún mensaje de error.
listProcessesInGuest

ruta al archivo .vmx

Enumera todos los procesos que se ejecutan en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

killProcessInGuest

ruta al archivo .vmx

ID de proceso

Detiene un proceso especificado en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. El identificador del proceso puede ser cualquier número que aparezca tras pid= en la salida de la opción listProcessesInGuest.

runScriptInGuest

ruta al archivo .vmx

[ -noWait | -activeWindow | -interactive ]

ruta del intérprete

texto del script

Ejecuta el script de comandos especificado en el sistema operativo invitado. Consulte la entrada runProgramInGuest para obtener una explicación de las opciones. La opción de ruta del intérprete ejecuta el script. Proporcione el texto completo del script, no un nombre de archivo. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.
deleteFileInGuest

ruta al archivo .vmx

ruta al archivo en el invitado

Elimina el archivo determinado del sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

createDirectoryInGuest

ruta al archivo .vmx

ruta de directorio en el invitado

Crea el directorio especificado en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

deleteDirectoryInGuest

ruta al archivo .vmx

ruta de directorio en el invitado

Elimina el directorio especificado del sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

createTempfileInGuest

ruta al archivo .vmx

Crea un archivo temporal en el sistema operativo invitado y devuelve el nombre de ruta del archivo temporal creado. El nombre de ruta varía según el sistema operativo. Puede ejecutar la opción deleteFileInGuest para eliminar el archivo. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

listDirectoryInGuest

ruta al archivo .vmx

ruta de directorio en el invitado

Enumera el contenido del directorio especificado en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

CopyFileFromHostToGuest

ruta al archivo .vmx

ruta de archivo en el host

ruta de archivo en el invitado

Copia un archivo desde el host al sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. Especifique el nombre de archivo de origen, o el nombre de archivo de host, antes del nombre de archivo de destino, o el nombre de archivo de invitado.

CopyFileFromGuestToHost

ruta al archivo .vmx

ruta de archivo en el invitado

ruta de archivo en el host

Copia un archivo desde el sistema operativo invitado al host. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. Especifique el nombre de archivo de origen, o el nombre de archivo de invitado, antes del nombre de archivo de destino, o el nombre de archivo de host.

renameFileInGuest

ruta al archivo .vmx

nombre de archivo original

nuevo nombre de archivo

Cambia el nombre a un archivo, o lo mueve, en el sistema operativo invitado. Se requiere VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. Especifique el nombre de archivo de origen, o el nombre de archivo original, antes del nombre de archivo de destino.

connectNamedDevice

ruta al archivo .vmx

nombre de dispositivo

Conecta el dispositivo denominado en el comando con el sistema operativo invitado. Solo se puede ejecutar este comando cuando la máquina virtual está encendida. Puede usar nombres de dispositivo, como sound, serial0, Ethernet0, sata0:1, etc.

Nota: Después de usar el comando vmrun connectNamedDevice para conectar un dispositivo de sonido desconectado a una máquina virtual en ejecución, si se apaga la máquina virtual podría desconectarse el dispositivo de sonido de la máquina virtual, incluso aunque la configuración de la máquina virtual indicara que el dispositivo de sonido está conectado.
disconnectNamedDevice

ruta al archivo .vmx

nombre de dispositivo

Desconecta el dispositivo denominado en el comando del sistema operativo invitado. Solo se puede ejecutar este comando cuando la máquina virtual está encendida. Puede usar nombres de dispositivo, como sound, serial0, Ethernet0, sata0:1, etc.

Nota: Después de usar el comando vmrun disconnectNamedDevice para desconectar un dispositivo de sonido conectado de una máquina virtual en ejecución, si se apaga la máquina virtual podría volver a conectarse el dispositivo de sonido a la máquina virtual, incluso aunque la configuración de la máquina virtual indicara que el dispositivo de sonido está desconectado.
captureScreen

ruta al archivo .vmx

ruta de salida en el host

Captura la pantalla de la máquina virtual a un archivo local. El archivo de salida especificado en el host está en formato PNG. Se requiere un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado.

writeVariable

ruta al archivo .vmx

[ guestVar | runtimeConfig | guestEnv ]

nombre de variable

valor de variable

Escribe una variable en el invitado o el estado de la máquina virtual. Puede establecer una variable de invitado no persistente, guestVar, una variable de configuración en tiempo de ejecución, runtimeConfig, tal como se almacena en el archivo .vmx o una variable de entorno, guestEnv, en el sistema operativo invitado. Una variable de invitado es un valor solo en tiempo de ejecución que proporciona una manera sencilla de pasar valores de tiempo de ejecución dentro y fuera del invitado. Las variables de entorno requieren VMware Tools y un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. Con Linux, la configuración del entorno de invitado requiere también el inicio de sesión como root.
readVariable

ruta al archivo .vmx

[ guestVar | runtimeConfig | guestEnv ]

nombre de variable

Lee una variable desde el invitado o el estado de la máquina virtual. Puede obtener una variable de invitado, una configuración en tiempo de ejecución tal como se almacena en el archivo .vmx o variables de entorno en el sistema operativo invitado. La lectura de la variable guestEnv requiere un inicio de sesión de invitado válido. Por ejemplo, puede usar las opciones -gu y -gp para iniciar sesión en el invitado. Consulte la entrada writeVariable para obtener una descripción de los tipos de variable.
getGuestIPAddress

ruta al archivo .vmx

[ -wait ]

Obtiene la dirección IP del invitado.

Cuando se utiliza la opción [ -wait ], el comando espera hasta que la dirección IP está disponible. Por ejemplo, la dirección IP no está disponible hasta que se enciende la máquina virtual. Si la red no está lista, el comando devuelve inmediatamente al símbolo de la línea de comandos.

Parámetros y comandos generales de vmrun

Opción Parámetros Descripción
list

Enumera todas las máquinas virtuales en ejecución.

upgradevm

ruta al archivo .vmx

Actualiza una máquina virtual a la versión de hardware virtual actual. No tiene ningún efecto si la versión de hardware virtual es la más reciente compatible.

Apague la máquina virtual, como con el comando vmrun stop. Espere un breve período de tiempo para que el comando termine. A continuación, ejecute el comando vmrun upgradevm.

installTools

ruta al archivo .vmx

Prepara la instalación de VMware Tools en el sistema operativo invitado. En los invitados de Windows con la ejecución automática habilitada, el instalador de VMware Tools se inicia automáticamente. En los invitados de Linux sin la ejecución automática, el comando conecta la unidad de CD‐ROM virtual a la imagen ISO de VMware Tools adecuada para el invitado, pero el instalador no se inicia.

Debe completar la instalación con los pasos manuales adicionales, como se describe en la documentación del producto.

checkToolsState

ruta al archivo .vmx

Comprueba el estado de VMware Tools en el invitado. Los estados posibles son desconocido, instalado y en ejecución.
deleteVM

ruta al archivo .vmx

Elimina una máquina virtual.
clone

ruta al archivo .vmx

ruta de archivo .vmx de destino

full|linked

[-snapshot=Snapshot Name]

[-cloneName=Name]

Solo Fusion Pro admite la opción clone.

Crea una copia de la máquina virtual.

Parámetros y comandos de la máquina virtual de plantilla de vmrun

Opción Parámetros Descripción
downloadPhotonVM

ruta para guardar la máquina virtual descargada

Descarga una máquina virtual de sistema operativo VMware Project Photon.