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 runlas usa solo para esta ejecución.script editsustituye 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,uiysign-insolo funcionan mientras la máquina virtual permite el control por agentes, igual que las esperas hasta que una máquina virtual puede ejecutar comandos, comostart --wait. Está activado salvo que alguien lo haya desactivado. Para volver a activarlo, ejecutavmpal set <VM> --agent-control on. - Sin shell.
execejecuta 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.
execlee la salida como texto, lo que altera la salida binaria. Copia los archivos binarios concp. - Administrador.
--adminejecuta un comando como administrador. En una máquina virtual de macOS, antes un administrador debe aprobarlo dentro de la máquina virtual.vmpal help execexplica cómo. - Límites de tiempo.
execdetiene un comando a las 2 horas, ycp, a la hora.--timeoutdefine otro límite, de hasta 24 horas. Las versiones antiguas de VMPal Tools permiten 10 minutos. - Sin entrada. Un comando de
execno recibe entrada. En una máquina virtual “Solo terminal”,vmpal sshte da entrada. - Copia de carpetas.
cpfunciona comocp -R. Por ejemplo,vmpal cp . "Ubuntu:src"copia el contenido de esta carpeta ensrc. - 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 --waityruninician 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-inlo desactiva. Para que Windows inicie sesión por sí solo en cada arranque, ejecutavmpal 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
vmpalharía que un script se ejecutara aquí: con--host, conscript runpara 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.