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

path to .vmx file

[ gui | nogui ]

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

path to .vmx file

[ hard | soft ]

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

path to .vmx file

[ hard | soft ]

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

path to .vmx file

[ hard | soft ]

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

path to .vmx file

Mette in pausa una macchina virtuale.

unpause

path to .vmx file

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

path to .vmx file

[ showtree ]

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

path to .vmx file

snapshot name

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

path to .vmx file

snapshot name

[ andDeleteChildren ]

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

path to .vmx file

snapshot name

o

path to .vmx file

Snapshot/"Snapshot 2"/"Snapshot N"

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

path to .vmx file

Elencare le schede di rete in una macchina virtuale.

addNetworkAdapter

path to .vmx file

Network adapter type

[ Host nework ]

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

path to .vmx file

Network adapter index

Network adapter type

[ Host nework ]

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

path to .vmx file

Network adapter index

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

host network name

Visualizza l'elenco di tutti i port forwarding disponibili in una rete host.

setPortForwarding

host network name

protocol

host port

guest ip

guest port

[Description]

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

host network name

protocol

host port

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

path to .vmx file

[ -noWait | -activeWindow | -interactive ]

program name

[ program arguments ]

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

path to .vmx file

Verifica se il file specificato è presente nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido.

directoryExistsInGuest

path to .vmx file

directory path on guest

Verifica se la directory specificata è presente nel sistema operativo guest. Sono necessari VMware Tools e un accesso guest valido.

setSharedFolderState

path to .vmx file

share name

path to folder on host

writable | readonly

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

path to .vmx file

share name

path to folder on host

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 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. Nei guest Windows, potrebbe verificarsi un ritardo prima che le cartelle condivise siano visibili per le opzioni runProgramInGuest, fileExistsInGuest e directoryExistsInGuest.

removeSharedFolder

path to .vmx file

share name

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 share name è un punto di montaggio nel file system guest.

enableSharedFolders

path to .vmx file

[runtime]

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

path to .vmx file

[runtime]

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

path to .vmx file

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

path to .vmx file

process ID

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

path to .vmx file

[ -noWait | -activeWindow | -interactive ]

interpreter path

script text

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

path to .vmx file

path to file on guest

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

path to .vmx file

directory path on guest

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

path to .vmx file

directory path on guest

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

path to .vmx file

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

path to .vmx file

directory path on guest

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

path to .vmx file

file path on host

file path in guest

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

path to .vmx file

file path in guest

file path on host

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

path to .vmx file

original filename

new filename

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

path to .vmx file

device name

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 vmrun connectNamedDevice 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

path to .vmx file

device name

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 vmrun disconnectNamedDevice 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

path to .vmx file

output path on host

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

path to .vmx file

[ guestVar | runtimeConfig | guestEnv ]

variable name

variable value

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

path to .vmx file

[ guestVar | runtimeConfig | guestEnv ]

variable name

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

path to .vmx file

[ -wait ]

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

path to .vmx file

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 vmrun stop. Attendere qualche minuto che l'esecuzione del comando venga completata. Eseguire quindi il comando vmrun upgradevm.

installTools

path to .vmx file

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

path to .vmx file

Verifica lo stato di VMware Tools nel guest. Gli stati possibili sono unknown (sconosciuto), installed (installato) e running (in esecuzione).
deleteVM

path to .vmx file

Elimina una macchina virtuale.
clone

path to .vmx file

destination .vmx file path

full|linked

[-snapshot=Snapshot Name]

[-cloneName=Name]

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

path to save the downloaded VM

Scarica una macchina virtuale con sistema operativo VMware Project Photon.