9.0

Using vmrun to Control Virtual Machines
12 VMware, Inc.
deleteSnapshot
(VMwareServeralways
deletestherootsnapshot.)
Removesasnapshotfromavirtualmachine(.vmxfile).
Forproductsthatsupportmultiplesnapshots,youmust
providethesnapshotname.
Thevirtualmachinemustbepoweredofforsuspended.
Ifthesnapshothaschildren,theybecomechildrenofthe
deletedsnapshot’sparent,andsub
sequentsnapshots
continueasbeforefromtheendofthechain.
TheandDeleteChildrenoptiondeletesthespecified
snapshotanditschildrenrecursively.
SeerevertToSnapshotforsolutionstonameconflicts.
<pathto.vmxfile>
<snapshotname>
[ andDeleteChildren ]
revertToSnapshot
(VMwareServeralways
revertstotherootsnapshot.)
Setsthevirtualmachinetoitsstateatsnapshottime.
How
everifthevirtualmachinewaspoweredonatthe
timeofthesnapshot,vmrunrevertsittosuspendedstate,
butdoesnotresumerunningthevirtualmachine.
Ifasnapshothasauniquenamewithinavirtual
machine,reverttothatsnapshotbyspecifyingthepath
tothevirtualmachine’scon
figurationfileandthe
uniquesnapshotname.
Ifseveralsnapshotshavethesamename,specifythe
snapshotbyincludingafullpathnameforthesnapshot.
Apathnameisaseriesofsnapshotnames,separatedby
forwardslashcharacters(/).Eachnamespecifiesanew
snapshotinthetree.Forexample,thepathname
Snap1/Snap2ident
ifiesasnapshotnamedSnap2that
wastakenfromthestateofasnapshotnamedSnap1.
<pathto.vmxfile>
<snapshotname>
or
<pathto.vmxfile>
<snap1/snap2/snapN>
Guest Operating System Commands
Thetimeout(waitforVMwareTools)isfiveminutesforallguest‐relatedcommands.
runProgramInGuest Runsaspecifiedprogramintheguestoperatingsys
tem.
The-noWaitoptionreturnsapromptimmediatelyafter
theprogramstartsintheguest,ratherthanwaitingforit
tofinish.Thisoptionisusefulforinteractiveprograms.
The-activeWindowoptionensuresthattheWindows
GUIisvisible,notminimized.IthasnoeffectonLinux.
The-interactiveoptionforcesinteractivegu
estlogin.
ItisusefulforVistaandWindows7gueststomakethe
programvisibleintheconsolewindow.
Youmustprovidethefullpathnameofaprogram
accessibletotheguest.Alsoprovidefullaccessible
pathnamesforanyfilesspecifiedintheprogram
arguments,accordingtorequirementsoftheprogram.
VM
wareToolsandavalidguestloginarerequired.
<pathto.vmxfile>
[ -noWait |
-activeWindow |
-interactive ]
<programname>
[<programarguments>]
runScriptInGuest Runsthespecifiedcommandscriptintheguest
operatingsystem.
SeerunProgramInGuestforanexplanationofoptions.
Theinterpreterpathisthecommandthatrunsthescript.
Providethecompletetextofth
escript,notafilename.
VMwareToolsandavalidguestloginarerequired.
<pathto.vmxfile>
[ -noWait |
-activeWindow |
-interactive ]
<interpreterpath>
<scripttext>
listProcessesInGuest Listsallprocessesrunningintheguestoperating
system.VMwareToolsandavalidguestloginare
required.
<pathto.vmxfile>
killProcessInGuest Stopsaspecifiedprocessintheguestope
ratingsystem.
VMwareToolsandavalidguestloginarerequired.
TheprocessIDcanbeanynumberlistedafterpid=in
theoutputoflistProcessesInGuest.
<pathto.vmxfile>
<processID>
fileExistsInGuest Checkswhetherthespecifiedfileexistsintheguest
operatingsystem.VMwareToolsandavalidguestlogin
arerequired.
<pat
hto.vmxfile>
<pathtofileonguest>
Table 2. vmrun Commands and Parameters (Continued)
Command Description Parameters