I comandi vmrun sono suddivisi in categorie in base alla funzione.
Nelle tabelle seguenti sono elencati i comandi vmrun e i parametri per Fusion in base alla loro funzione. I parametri sono elencati uno per riga. I parametri racchiusi tra parentesi quadre sono facoltativi. La barra verticale indica una scelta di parola chiave.
Comandi di alimentazione vmrun e parametri
| Opzione | Parametri | Descrizione |
|---|---|---|
| start | |
Avvia una macchina virtuale. L'impostazione predefinita gui avvia la macchina in modo interattivo, operazione necessaria per visualizzare l'interfaccia di Fusion. L'opzione nogui elimina l'interfaccia di Fusion, inclusa la finestra di dialogo di avvio, per consentire lo scripting non interattivo.
Nota: Per avviare le macchine virtuali crittografate, utilizzare il contrassegno
nogui. L'utility
vmrun non supporta la modalità GUI con le macchine virtuali crittografate.
|
| stop | |
Arresta una macchina virtuale. Utilizzare l'opzione soft per spegnere il guest dopo l'esecuzione degli script di arresto. Utilizzare l'opzione hard per spegnere il guest senza l'esecuzione di script, come se si premesse sul pulsante di alimentazione. L'impostazione predefinita prevede l'utilizzo del valore powerType specificato nel file .vmx, se presente. |
| reset | |
Reimposta una macchina virtuale. Utilizzare l'opzione soft per eseguire gli script di arresto prima del riavvio del guest. Utilizzare l'opzione hard per riavviare il guest senza l'esecuzione di script, come se si premesse sul pulsante Reimposta. L'impostazione predefinita prevede l'utilizzo del valore powerType specificato nel file .vmx, se presente. |
| suspend | |
Sospende una macchina virtuale senza arrestarla, in modo da poter riprendere le operazioni in locale in un secondo momento. L'opzione soft sospende il guest dopo l'esecuzione degli script di sistema. Nei guest Windows, questi script rilasciano l'indirizzo IP. Nei guest Linux, gli script sospendono i servizi di rete. L'opzione hard sospende il guest senza l'esecuzione degli script. L'impostazione predefinita prevede l'utilizzo del valore powerType specificato nel file .vmx, se presente. Per riprendere le operazioni della macchina virtuale al termine dell'esecuzione del comando suspend, utilizzare il comando start. In Windows, l'indirizzo IP viene recuperato. In Linux, i servizi di rete vengono riavviati. |
| pause | |
Mette in pausa una macchina virtuale. |
| unpause | |
Riprende le operazioni di una macchina virtuale da dove erano state interrotte prima che venisse messa in pausa. |
Comandi di snapshot vmrun e relativi parametri
| Opzione | Parametri | Descrizione |
|---|---|---|
| listSnapshots | |
Elencare tutti gli snapshot in una macchina virtuale. L'opzione showtree visualizza gli snapshot in una struttura ad albero con gli elementi figlio sotto l'elemento genitore. |
| snapshot | |
Crea uno snapshot di una macchina virtuale. Poiché Fusion supporta più snapshot, è necessario specificare il nome dello snapshot. Poiché la barra definisce i nomi di percorso, non utilizzare il carattere barra nel nome dello snapshot. In caso contrario, diventerà difficile specificare il percorso dello snapshot in un secondo momento. |
| deleteSnapshot | |
Rimuove uno snapshot da una macchina virtuale. Poiché Fusion supporta più snapshot, è necessario specificare il nome dello snapshot. La macchina virtuale deve essere spenta o sospesa. Gli eventuali figli inclusi nello snapshot diventano figli dell'elemento genitore dello snapshot eliminato e gli snapshot successivi continuano come prima dalla fine della catena. L'opzione andDeleteChildren elimina lo snapshot specificato e i rispettivi figli in modo ricorsivo. Per le soluzioni dei conflitti dei nomi, vedere revertToSnapshot. |
| revertToSnapshot | o |
Imposta la macchina virtuale sullo stato che aveva al momento dello snapshot. Se la macchina virtuale è stata accesa al momento dello snapshot, vmrun ne ripristina lo stato sospeso, ma non riprende l'esecuzione della macchina virtuale. Se uno snapshot ha un nome univoco all'interno di una macchina virtuale, ripristinare tale snapshot specificando il percorso del file di configurazione della macchina virtuale e il nome univoco dello snapshot. Se più snapshot hanno lo stesso nome, specificare lo snapshot includendo un nome di percorso completo per lo snapshot. Un nome di percorso è una serie di nomi di snapshot, separati da caratteri barra (/). Ciascun nome specifica un nuovo snapshot nell'albero. Ad esempio, il nome di percorso Snap1/Snap2 identifica uno snapshot denominato Snap2 che è stato creato dallo stato di uno snapshot denominato Snap1. |
Comandi della scheda di rete vmrun e parametri
Solo Fusion Pro supporta i comandi della scheda di rete.
| Opzione | Parametri | Descrizione |
|---|---|---|
| listNetworkAdapters | |
Elencare le schede di rete in una macchina virtuale. |
| addNetworkAdapter | |
Aggiunge una scheda di rete in una macchina virtuale.
Nota: Il tipo di scheda di rete può essere
nat,
hostOnly,
bridged o
custom. Quando la scheda di rete è
nat,
hostOnly o
bridged, il parametro
Host nework non è necessario. Solo quando il tipo di scheda di rete è
custom, è necessario specificare un valore per il parametro
Host nework. Ad esempio,
. vmrun addNetworkAdapter .vmx file custom vmnet3.
A una macchina virtuale personalizzata è necessario assegnare uno dei nomi elencati nella sezione Ad hoc del pannello delle impostazioni di rete della macchina virtuale o nel pannello delle preferenze di rete di Fusion. |
| setNetworkAdapter | |
Aggiorna una scheda di rete in una macchina virtuale.
Nota: Il tipo di scheda di rete può essere
nat,
hostOnly,
bridged o
custom. Quando la scheda di rete è
nat,
hostOnly o
bridged, il parametro
Host nework non è necessario. Solo quando il tipo di scheda di rete è
custom, è necessario specificare un valore per il parametro
Host nework. Ad esempio,
vmrun addNetworkAdapter .vmx file custom vmnet3.
A una macchina virtuale personalizzata è necessario assegnare uno dei nomi elencati nella sezione Ad hoc del pannello delle impostazioni di rete della macchina virtuale o nel pannello delle preferenze di rete di Fusion. |
| deleteNetworkAdapter | |
Rimuove una scheda di rete da una macchina virtuale. |
Comandi di rete host vmrun e parametri
Solo Fusion Pro supporta i comandi di rete host.
| Opzione | Parametri | Descrizione |
|---|---|---|
| listHostNetworks | Visualizza l'elenco di tutte le reti nell'host. |
|
| listPortForwardings | |
Visualizza l'elenco di tutti i port forwarding disponibili in una rete host. |
| setPortForwarding | |
Imposta un inoltro della porta in una rete host.
Nota: Per evitare che il comando restituisca un errore, usare l'utility
sudo con questa opzione. Ad esempio,
sudo vmrun setPortForwarding.
|
| deletePortForwarding | |
Elimina un inoltro della porta in una rete host.
Nota: Per evitare che il comando restituisca un errore, usare l'utility
sudo con questa opzione. Ad esempio,
sudo vmrun deletePortForwarding.
|
Comandi del sistema operativo guest vmrun e parametri
Il timeout, ovvero il tempo di attesa per VMware Tools, è di cinque minuti per tutti i comandi relativi al guest.
| Opzione | Parametri | Descrizione |
|---|---|---|
| runProgramInGuest | |
Esegue un programma specificato nel sistema operativo guest. L'opzione -noWait restituisce una richiesta di conferma immediatamente dopo l'avvio del programma nel guest, anziché attenderne il completamento. Questa opzione è utile per i programmi interattivi. L'opzione -activeWindow assicura che la GUI di Windows sia visibile e non ridotta a icona. Non ha alcun effetto su Linux. L'opzione -interactive forza l'accesso guest interattivo. L'opzione è utile per i guest Windows Vista e Windows 7 o versioni successive per rendere il programma visibile nella finestra della console. È necessario specificare il nome di percorso completo di un programma accessibile per il guest. Specificare inoltre i nomi dei percorsi completamente accessibili per tutti i file specificati negli argomenti del programma, in base ai requisiti del programma. Sono necessari VMware Tools e un accesso guest valido. |
| fileExistsInGuest | |
Verifica se il file specificato è presente nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. |
| directoryExistsInGuest | |
Verifica se la directory specificata è presente nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. |
| setSharedFolderState | |
Modifica lo stato di scrittura di una cartella specificata condivisa tra l'host e una macchina virtuale guest. Il valore per il parametro share name è un punto di montaggio nel file system guest. Il valore per il parametro path to folder on host è la directory esportata nell'host. Per rendere una cartella condivisa scrivibile o di sola lettura, includere il parametro writable o readonly. |
| addSharedFolder | |
Aggiunge una cartella da condividere tra l'host e il guest. Affinché l'opzione addSharedFolder abbia effetto, la macchina virtuale deve essere in esecuzione. Il valore per il parametro |
| removeSharedFolder | |
Rimuove l'accesso della macchina virtuale guest a una cartella condivisa nell'host. Affinché l'opzione removeSharedFolder abbia effetto, la macchina virtuale deve essere in esecuzione. Il valore per il parametro |
| enableSharedFolders | |
Consente alla macchina virtuale guest, specificata dal file
.vmx, di condividere le cartelle con il relativo host. Dopo l'abilitazione, eseguire l'opzione
addSharedFolder per specificare ogni cartella dell'host da condividere. L'argomento
[runtime] facoltativo consente la condivisione delle cartelle finché la macchina virtuale non viene spenta. In caso contrario, l'impostazione persiste all'accensione successiva.
Nota: L'opzione
enableSharedFolders diventa effettiva dopo l'arresto e il riavvio del guest. Non viene visualizzato alcun messaggio di errore.
|
| disableSharedFolders | |
Impedisce alla macchina virtuale guest, specificata dal file
.vmx, di condividere le cartelle con il relativo host. L'argomento
[runtime] facoltativo impedisce la condivisione delle cartelle finché la macchina virtuale non viene spenta. In caso contrario, l'impostazione persiste all'accensione successiva.
Nota: L'opzione
disableSharedFolders diventa effettiva dopo l'arresto e il riavvio del guest. Non viene visualizzato alcun messaggio di errore.
|
| listProcessesInGuest | |
Visualizza l'elenco di tutti i processi in esecuzione nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| killProcessInGuest | |
Interrompe un processo specificato nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. L'ID processo può essere un numero qualsiasi elencato dopo pid= nell'output dell'opzione listProcessesInGuest. |
| runScriptInGuest | |
Esegue lo script del comando specificato nel sistema operativo guest. Per una spiegazione delle opzioni, vedere la voce runProgramInGuest. L'opzione interpreter path esegue lo script. Specificare il testo completo dello script, non un nome di file. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| deleteFileInGuest | |
Elimina il file specificato dal sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| createDirectoryInGuest | |
Crea la directory specificata nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| deleteDirectoryInGuest | |
Elimina la directory specificata dal sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| createTempfileInGuest | |
Crea un file temporaneo nel sistema operativo guest e restituisce il nome del percorso del file temporaneo creato. Il nome del percorso varia in base al sistema operativo. È possibile eseguire l'opzione deleteFileInGuest per rimuovere il file. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| listDirectoryInGuest | |
Elencare i contenuti della directory specificata nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| CopyFileFromHostToGuest | |
Copia un file dall'host al sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. Specificare il nome del file di origine, o nome del file host, prima del nome del file di destinazione, o nome del file guest. |
| CopyFileFromGuestToHost | |
Copia un file dal sistema operativo guest all'host. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. Specificare il nome del file di origine, o nome del file guest, prima del nome del file di destinazione, o nome del file host. |
| renameFileInGuest | |
Rinomina o sposta un file nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. Specificare il nome del file di origine, o nome del file originale, prima del nome del file di destinazione. |
| connectNamedDevice | |
Connette il dispositivo denominato nel comando al sistema operativo guest. È possibile eseguire questo comando solo quando la macchina virtuale è accesa. È possibile utilizzare nomi di dispositivo, come sound, serial0, Ethernet0, sata0:1 e così via.
Nota: Dopo aver utilizzato il comando
vmrunconnectNamedDevice per connettere un dispositivo audio disconnesso a una macchina virtuale in esecuzione, se si spegne la macchina virtuale, è possibile che il dispositivo audio venga disconnesso dalla macchina virtuale, anche se le impostazioni della macchina virtuale indicano che il dispositivo audio è connesso.
|
| disconnectNamedDevice | |
Disconnette il dispositivo denominato nel comando dal sistema operativo guest. È possibile eseguire questo comando solo quando la macchina virtuale è accesa. È possibile utilizzare nomi di dispositivo, come sound, serial0, Ethernet0, sata0:1 e così via.
Nota: Dopo aver utilizzato il comando
vmrundisconnectNamedDevice per disconnettere un dispositivo audio connesso da una macchina virtuale in esecuzione, se si spegne la macchina virtuale, è possibile che il dispositivo audio venga riconnesso alla macchina virtuale, anche se le impostazioni della macchina virtuale indicano che il dispositivo audio è disconnesso.
|
| captureScreen | |
Acquisisce la schermata della macchina virtuale in un file locale. Il file di output specificato nell'host è in formato PNG. È necessario un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. |
| writeVariable | |
Scrive una variabile nel guest o nello stato della macchina virtuale. È possibile impostare un variabile guest non persistente, guestVar, una variabile di configurazione di runtime, runtimeConfig, come nel file .vmx, o una variabile di ambiente, guestEnv, nel sistema operativo guest. Una variabile guest è un valore di solo runtime che offre un modo semplice per passare i valori di runtime all'interno e al di fuori del guest. Le variabili di ambiente richiedono VMware Tools e un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. Con Linux, l'impostazione dell'ambiente guest richiede anche l'accesso root. |
| readVariable | |
Legge una variabile dal guest o dallo stato della macchina virtuale. È possibile ottenere una variabile guest, una configurazione di runtime come nel file .vmx o le variabili di ambiente nel sistema operativo guest. La lettura della variabile guestEnv richiede un accesso guest valido. Ad esempio, è possibile utilizzare le opzioni -gu e -gp per accedere al guest. Per una descrizione dei tipi di variabile, vedere la voce writeVariable. |
| getGuestIPAddress | |
Recupera l'indirizzo IP del guest. Quando si utilizza l'opzione [ -wait ], il comando attende che l'indirizzo IP sia disponibile. Ad esempio, l'indirizzo IP non è disponibile finché la macchina virtuale non è accesa. Se la rete non è pronta, il comando torna immediatamente al prompt della riga di comando. |
Comandi generici vmrun e relativi parametri
| Opzione | Parametri | Descrizione |
|---|---|---|
| list | Visualizza l'elenco di tutte le macchine virtuali in esecuzione. |
|
| upgradevm | |
Aggiorna una macchina virtuale alla versione dell'hardware virtuale corrente. Non ha alcun effetto se la versione dell'hardware virtuale è la più recente supportata. Spegnere la macchina virtuale, ad esempio con il comando |
| installTools | |
Prepara l'installazione di VMware Tools nel sistema operativo guest. Nei guest Windows in cui è abilitata l'esecuzione automatica, il programma di installazione di VMware Tools viene avviato automaticamente. Nei guest Linux senza l'esecuzione automatica, il comando connette l'unità CD‐ROM virtuale all'immagine ISO di VMware Tools idonea per il guest, ma il programma di installazione non si avvia. È necessario completare l'installazione con passaggi manuali aggiuntivi, come descritto nella documentazione del prodotto. |
| checkToolsState | |
Verifica lo stato di VMware Tools nel guest. Gli stati possibili sono unknown (sconosciuto), installed (installato) e running (in esecuzione). |
| deleteVM | |
Elimina una macchina virtuale. |
| clone | |
Solo Fusion Pro supporta l'opzione clone. Crea una copia della macchina virtuale. |
Comandi della macchina virtuale modello vmrun e relativi parametri
| Opzione | Parametri | Descrizione |
|---|---|---|
| downloadPhotonVM | |
Scarica una macchina virtuale con sistema operativo VMware Project Photon. |
