Sintaxis de los comandos vmrun

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 vmrunconnectNamedDevice 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 vmrundisconnectNamedDevice 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.