Ir al contenido

Documentación Línea de comandos Línea de comandos

Comandos

vmpal es la herramienta de línea de comandos de VMPal, como docker o gh. Esta página resume todos los comandos y, después, las reglas que conviene conocer. Ejecuta vmpal help <command> para ver las opciones de un comando y vmpal help <topic> para leer una guía.

En las tablas, <VM> es el nombre de una máquina virtual, su ID o sus 4 primeros caracteres o más, o la ruta de su carpeta .vmpal. vmpal list los muestra.

Pregúntale a tu agente de IA

Tu agente de IA puede hacer todo esto por ti. VMPal le da la ayuda y las guías de todos los comandos, así que puede escribir los comandos o ejecutarlos. Conéctalo a VMPal y pídele, por ejemplo:

  • “¿Qué comando de vmpal copia una carpeta a mi máquina virtual de Windows?”
  • “Clona mi máquina virtual de Ubuntu, ejecuta las pruebas en el clon y luego elimínalo.”

Máquinas virtuales

Comando Qué hace
vmpal list Enumera tus máquinas virtuales y lo que está haciendo cada una
vmpal info <VM> Muestra una máquina virtual al completo
vmpal systems Enumera los sistemas que puedes instalar, con sus ID. También indica cuáles pueden ser “Solo terminal”
vmpal create <system> --wait Crea una máquina virtual y espera hasta que esté instalada y pueda ejecutar comandos
vmpal create --file <path> Instala desde un archivo IPSW o ISO en lugar de un ID de sistema
vmpal create <system> --terminal-only Instala Linux sin escritorio
vmpal create <system> --password-file <path> Escribe la contraseña de la nueva máquina virtual en un archivo que solo tú puedes leer
vmpal clone <VM> Clona una máquina virtual apagada. El clon está listo al instante
vmpal clone <VM> --shut-down Primero apaga la máquina virtual y después la clona
vmpal clone <VM> --start --wait También inicia el clon y espera hasta que pueda ejecutar comandos
vmpal set <VM> --cpus 4 --memory 8 Cambia los ajustes de una máquina virtual, como el hardware, las carpetas compartidas, los puertos, la red y el inicio de sesión. vmpal help set los enumera todos
vmpal set <VM> --display 1440x900@2x Mantiene la pantalla de la máquina virtual con ese tamaño en puntos y esa escala, 1x o 2x, en cualquier monitor y en segundo plano. La ventana la muestra escalada para que quepa, y los clones la conservan. Úsalo para pruebas de interfaz y capturas de pantalla. window vuelve a seguir a la ventana
vmpal set <VM> --render-scale 75 Renderiza la pantalla de una máquina virtual de Windows al 75 % o al 50 % de cada lado de su ventana, y la amplía con MetalFX. Cuanto más bajo, más rápido van los juegos que la GPU frena, y más suave se ve la imagen. 100 vuelve al tamaño completo
vmpal set <VM> --user <name> Le indica a VMPal el nombre de la cuenta en la máquina virtual, si VMPal no la creó o se le cambió el nombre allí. No cambia el nombre de nada en la máquina virtual
vmpal delete <VM> Traslada una máquina virtual a la papelera
vmpal delete <VM> --force Primero fuerza el apagado de una máquina virtual en marcha y después la traslada a la papelera
vmpal delete <VM> --permanently La elimina definitivamente, sin pasar por la papelera
vmpal import <path> Importa un archivo .vmpalvm de otro Mac o una máquina virtual de Parallels. Una carpeta .vmpal se añade donde está
vmpal move <VM> <location> Mueve una máquina virtual apagada a otra de las ubicaciones de VMPal. --wait espera hasta que esté allí
vmpal compress <VM> Empaqueta una máquina virtual en un archivo .vmpalvm para otro Mac. Se guarda en el Escritorio, salvo que --output indique otra cosa
vmpal cancel <VM> Detiene la descarga o el traslado de una máquina virtual
vmpal cancel Detiene la importación o la compresión en curso

vmpal help create enumera las demás opciones de create: --name, --cpus, --memory, --disk, --location, --user, --install-updates para Linux, --sign-in-automatically para Windows, --start-at-login y --no-agent-control.

Las CPU, la memoria, la GPU y algunos otros ajustes esperan a que la máquina virtual se apague y vuelva a iniciarse. vmpal restart <VM> --apply-settings lo hace por ti.

Encendido y apagado

Comando Qué hace
vmpal start <VM> --wait Inicia una máquina virtual y espera hasta que pueda ejecutar comandos
vmpal start <VM> --background La inicia sin su ventana. vmpal show abre la ventana
vmpal start <VM> --recovery Inicia una máquina virtual de macOS en la recuperación de macOS
vmpal stop <VM> La apaga
vmpal stop <VM> --force La apaga al instante, como si la desenchufaras
vmpal pause <VM> Pone en pausa una máquina virtual en marcha
vmpal resume <VM> Reanuda una máquina virtual en pausa
vmpal suspend <VM> Guarda su sesión en el disco y la cierra. vmpal start continúa donde se quedó
vmpal restart <VM> Reinicia el sistema de la máquina virtual
vmpal restart <VM> --apply-settings La apaga y la vuelve a iniciar, para los ajustes que lo requieren
vmpal restart <VM> --reset La reinicia al instante, como si pulsaras un botón de reinicio
vmpal show <VM> Trae al frente la ventana de una máquina virtual en marcha
vmpal show <VM> --apps-on-mac Muestra las apps de una máquina virtual de Windows como ventanas del Mac, cada una por separado, como hace Visualización › Ejecutar apps de Windows en el Mac. Una máquina virtual de Linux con aceleración por GPU hace lo mismo, como Visualización › Ejecutar apps de Linux en el Mac. La máquina virtual se abrirá así la próxima vez
vmpal show <VM> --window Vuelve a mostrar la ventana de la máquina virtual en lugar de sus apps
vmpal wait <VM> Espera hasta que pueda ejecutar comandos. De forma predeterminada, desiste a los 10 minutos
vmpal wait <VM> --until stopped Espera, en cambio, hasta que esté stopped. --until también acepta running e installed

Las esperas desisten a los 5 minutos en start, stop y clone --start, y a los 10 minutos en start --wait, clone --start --wait, restart --wait y wait. create --wait, move --wait y compress --wait desisten a las 2 horas. --timeout define otro límite, de hasta 24 horas.

Dentro de una máquina virtual

Comando Qué hace
vmpal exec <VM> -- <command> Ejecuta un comando en la máquina virtual, como docker exec. Ves su salida a medida que llega
vmpal exec <VM> --arch x64 -- <command> Ejecuta la parte x64 de un programa compilado para arm64 y x64. --arch arm64 ejecuta la otra
vmpal cp <from> <to> Copia archivos hacia dentro o hacia fuera, como docker cp. Escribe el lado de la máquina virtual como <VM>:<path>
vmpal run <VM> -- <command> Ejecuta un comando en un clon nuevo de una máquina virtual apagada, como un runner de CI recién creado. --copy-in y --copy-out copian archivos. Después, VMPal elimina el clon. CI/CD explica cómo
vmpal ssh <VM> Inicia sesión en una máquina virtual de Linux “Solo terminal” con el ssh de este Mac. Obtienes entrada y una terminal
vmpal ssh <VM> -- <command> Ejecuta allí un comando por ssh
vmpal ssh <VM> --tty -- <command> También le da una terminal al comando, como ssh -t, para programas como top
vmpal sign-in <VM> Inicia sesión en su pantalla de inicio de sesión con la contraseña que guarda VMPal
vmpal ui <VM> ... Lee las ventanas, los botones y los textos de la pantalla, y cualquier aviso del sistema operativo, como el UAC de Windows (vmpal ui <VM> tree); hace clic, escribe y hace capturas de pantalla. vmpal ui help explica cómo
vmpal status <VM> Muestra si puede ejecutar comandos, su pantalla y quién tiene su entrada
vmpal send-files <VM> <path>... Coloca archivos en el escritorio de su usuario, como si los soltaras allí
vmpal reinstall-tools <VM> Vuelve a instalar VMPal Tools en ella

Instantáneas

Una instantánea guarda una máquina virtual tal como está ahora, para que puedas volver a ese estado más adelante.

Comando Qué hace
vmpal snapshot <VM> [name] Crea una instantánea
vmpal snapshots <VM> Enumera sus instantáneas
vmpal revert <VM> [name] Vuelve a una instantánea. Sin nombre, vuelve a la más reciente
vmpal revert <VM> --snapshot-first Guarda el estado actual en una nueva instantánea y después vuelve atrás
vmpal rename-snapshot <VM> <snapshot> <new name> Cambia el nombre de una instantánea
vmpal delete-snapshot <VM> <snapshot> Elimina una instantánea definitivamente

Hub

Estos comandos gestionan los scripts del Hub de VMPal. Un script es un script de shell o de PowerShell que VMPal guarda y ejecuta por ti. Tu agente de IA hace lo mismo con las herramientas MCP de VMPal.

<script> es el nombre de un script, en mayúsculas o minúsculas, o su ID.

Comando Qué hace
vmpal script create <name> --file <path> Añade un script al Hub de VMPal. --file - lo lee de la entrada estándar. Si otro script ya tiene ese nombre, se le añade un número, como “Test App 2”
vmpal script edit <script> Cambia su nombre (--name), su texto (--file), sus ajustes o dónde se ejecuta. --no-targets hace que no se ejecute en ningún sitio
vmpal script show <script> Muestra sus ajustes, dónde se ejecuta, sus 5 últimas ejecuciones con las rutas de sus registros, y su texto
vmpal script list Enumera todos los scripts, con su lenguaje, su color y dónde se ejecutan
vmpal script run <script> --wait Lo ejecuta ahora y espera a que terminen sus ejecuciones
vmpal script stop <script> Detiene sus ejecuciones en espera o en curso. --run <ID> detiene solo una
vmpal script runs <script> Enumera sus ejecuciones, de la más reciente a la más antigua, con sus ID, sus estados y por qué fallaron: las 50 últimas que terminaron y las que están en espera o en curso. --limit <n> define cuántas, hasta 100
vmpal script log <script> Imprime el registro de la ejecución más reciente. --run <ID> imprime el registro de otra ejecución. --tail <bytes> imprime solo su final
vmpal script duplicate <script> Copia un script, justo detrás de él en la lista del Hub
vmpal script move <script> --before <script> Lo mueve hacia arriba o hacia abajo en la lista del Hub. --to-end lo mueve al final
vmpal script delete <script> Lo elimina, junto con sus ejecuciones y sus registros. Las ejecuciones en curso se detienen

Estas opciones eligen dónde se ejecuta un script. Las aceptan script create, script edit y script run.

Opción Dónde se ejecuta el script
--run-in <VM> En un clon nuevo de la máquina virtual, una copia desechable como un runner de CI recién creado
--run-in-place <VM> En la propia máquina virtual
--host En este Mac, como tú
  • script run las usa solo para esta ejecución.
  • script edit sustituye con ellas los lugares donde se ejecuta.
  • Una ejecución espera hasta 30 minutos a su máquina virtual, por ejemplo, a que se apague antes de clonarla.

Estas opciones cambian los ajustes de un script, en script create y script edit:

Opción Qué define
--language powershell Lo convierte en un script de PowerShell. Un archivo .ps1 ya lo es
--timeout <duration> Cuánto puede durar una ejecución. El valor predeterminado es 1 hora, y el máximo, 24 horas
--color <color> Tiñe su fila en el Hub: red, orange, yellow, green, mint, teal, cyan, blue, indigo, purple, pink, brown o gray. En script edit, --color none lo quita

script run --wait termina como un trabajo de CI, así que su código de salida te indica si las ejecuciones han sido correctas. En script run, --timeout es cuánto espera vmpal a las ejecuciones, no cuánto puede durar una ejecución. De forma predeterminada, espera el tiempo límite del script más 35 minutos.

Teléfonos y tabletas

Un iPhone, iPad, simulador de iOS o dispositivo Android de la sección Remoto de VMPal, indicado por su nombre: consulta Teléfonos y tabletas. vmpal start <phone> lo conecta, y después vmpal ui <phone> usa su pantalla, igual que la de una máquina virtual.

Comando Qué hace
vmpal device <phone> install <path> Instala una app: un .app o .ipa firmado para ese iPhone, un .app de simulador o un .apk de Android
vmpal device <phone> launch <bundle ID> La inicia (antes la cierra si está en marcha) y guarda lo que imprime. Sus propios argumentos van después de --. --no-console no guarda nada
vmpal device <phone> logs <bundle ID> Lo que ha impreso desde que launch la inició. En Android, su logcat. --lines <n> para ver más o menos líneas
vmpal device <phone> crashes [<bundle ID>] Sus informes de errores, del más reciente al más antiguo. vmpal device <phone> crash <report> lee uno
vmpal device <phone> apps Las apps instaladas, no las del sistema
vmpal device <phone> terminate <bundle ID> La cierra. uninstall la elimina
vmpal device <phone> rotate landscape-left Lo gira: portrait, landscape-left, landscape-right o upside-down
vmpal device <phone> button home Pulsa un botón: home, volume-up o volume-down, y en Android back, recents o power
vmpal device <phone> open-url <url> Abre una página web o un enlace propio de una app
vmpal device <phone> pinch --scale 2 Pellizca con dos dedos, en el centro salvo que --x y --y indiquen otro punto, de 0 a 1. Un valor mayor que 1 amplía
vmpal device <phone> release Termina la sesión de pruebas de VMPal en un iPhone o iPad, para que Xcode pueda ejecutar allí tus propias pruebas de interfaz

Otros

Comando Qué hace
vmpal library Muestra las ubicaciones de VMPal, sus imágenes del sistema y las descargas, la importación o la compresión en curso
vmpal add-location <path> Añade una carpeta en la que VMPal guarde máquinas virtuales, por ejemplo, en otro disco
vmpal remove-location <path> Quita una carpeta de la lista de VMPal. Sus máquinas virtuales se quedan en ella
vmpal delete-base-os <id> Traslada una imagen del sistema a la papelera
vmpal diagnostics Comprime en un zip los registros de VMPal, los informes de errores y los ajustes de las máquinas virtuales para un informe de errores, y te indica cómo enviarlo. Las contraseñas se excluyen
vmpal diagnostics <VM> Lo mismo para una máquina virtual: su registro completo y solo sus archivos
vmpal diagnostics --problem <text> Describe qué ha salido mal, para el informe de errores
vmpal tool <name> [<json>] Llama a una de las herramientas MCP de VMPal por su nombre, con sus argumentos en JSON. --file <path> los lee de un archivo, y -, de la entrada estándar. --show-password mantiene la contraseña de una máquina virtual en la respuesta
vmpal help Enumera todos los comandos
vmpal help <command> Muestra las opciones y la guía de un comando
vmpal help <topic> Lee una guía: setup, ci, exec, cp, sign-in o ui

Reglas que conviene conocer

Comandos en una máquina virtual

  • Control por agentes. exec, cp, run, ssh, ui y sign-in solo funcionan mientras la máquina virtual permite el control por agentes, igual que las esperas hasta que una máquina virtual puede ejecutar comandos, como start --wait. Está activado salvo que alguien lo haya desactivado. Para volver a activarlo, ejecuta vmpal set <VM> --agent-control on.
  • Sin shell. exec ejecuta el propio programa, sin shell. Para usar tuberías y &&, ejecuta tú mismo un shell: vmpal exec "Ubuntu" -- /bin/sh -c 'make && make test'.
  • Salida de texto. exec lee la salida como texto, lo que altera la salida binaria. Copia los archivos binarios con cp.
  • Administrador. --admin ejecuta un comando como administrador. En una máquina virtual de macOS, antes un administrador debe aprobarlo dentro de la máquina virtual. vmpal help exec explica cómo.
  • Límites de tiempo. exec detiene un comando a las 2 horas, y cp, a la hora. --timeout define otro límite, de hasta 24 horas. Las versiones antiguas de VMPal Tools permiten 10 minutos.
  • Sin entrada. Un comando de exec no recibe entrada. En una máquina virtual “Solo terminal”, vmpal ssh te da entrada.
  • Copia de carpetas. cp funciona como cp -R. Por ejemplo, vmpal cp . "Ubuntu:src" copia el contenido de esta carpeta en src.
  • Inicio de sesión. Windows solo ejecuta comandos después de que alguien inicie sesión. Por eso, create --wait, start --wait, wait, clone --start --wait, restart --wait y run inician sesión por ti, con la contraseña que guarda VMPal. Lo hacen en una pantalla de inicio de sesión de Windows o macOS. --no-sign-in lo desactiva. Para que Windows inicie sesión por sí solo en cada arranque, ejecuta vmpal set <VM> --sign-in-automatically on.

Códigos de salida

El código de salida le indica a tu script o a tu trabajo de CI si un comando ha funcionado, como con cualquier herramienta de línea de comandos.

Comando Código de salida
exec y run El del propio comando. 124 cuando se agotó el tiempo límite, 125 cuando vmpal no pudo ejecutarlo, 128 + N con la señal N, y 1 para un código fuera del rango de 0 a 255, como el 0xC0000005 de Windows, que vmpal imprime
ssh El del propio ssh. 255 cuando no pudo conectarse, y 125 cuando vmpal no pudo iniciarlo
script run --wait 0 cuando todas las ejecuciones fueron correctas. Si no, el código de salida de la ejecución cuando hubo una sola, o 1
Cualquier otro comando 0 cuando ha funcionado, 1 cuando no, y 2 para una línea de comandos incorrecta

Scripts

  • Los scripts en este Mac se ejecutan como tú. Por eso, VMPal comprueba su ajuste Scripts en este Mac cada vez que vmpal haría que un script se ejecutara aquí: con --host, con script run para un script que se ejecuta en este Mac y con un texto nuevo para un script así. El ajuste tiene tres opciones:
    • Permitir (los agentes te preguntan), la predeterminada, lo deja pasar sin preguntar.
    • Preguntar en VMPal te pregunta una vez por cada versión del script.
    • Desactivado lo rechaza.