9.0

VMware, Inc. 9
Using vmrun to Control Virtual Machines
Windows Setup
To use the vmrun utility on Windows
1IfyouarerunningVMwareWorkstation,acopyofvmrunisincludedinthefolderwhereyouinstalled
Workstation.IfyouinstalltheVIXAPI,apossiblynewervmrunisplacedinoneofthesefolders:
32‐bitsystems–C:\Program Files\VMware\VMware VIX
64‐bitsystems–C:\Program Files (x86)\VMware\VMware VIX
2 (Optional)Mostusersfinditconv
enienttoaddthevmruninstalllocation,eitherVMwareWorkstationor
VMwareVIX,tothesystempath.OnWindows7:
(right‐click)Computer>(click)Properties>AdvancedSystemSettings>EnvironmentVariables>
(inlistof)SystemVariables>(select)Path>(click)Edit
Withtherightarrowkey,movetheins
ertionpointtotheendofline,addasemicolon,addthefullpath
ofthefolderwherevmrunislocated,andclickOKthreetimes.
3Inacommandwindow,typevmruntoseecommand‐lineoptions.
Mac OS X Setup
To use the vmrun utility on Mac OS
1InaTerminalwindow,addtheVMwareFusion(4.0andlater)directorytoyoursystempath.
export PATH="$PATH:/Applications/VMware\ Fusion.app/Contents/Library"
2Typevmruntoseecommand‐lineoptions.
Specifying the VMware Product Platform
Thevmrunutilityacceptsoptionflags,commands,andparametersinthefollowingsyntax:
vmrun <flags> <command> <parameters>
Inthefollowingsyntaxexamples,optionsenclosedinanglebracketsindicatevariablesthatyousupply.
Encrypted Virtual Machines
Encryptedvirtualmachinesrequireapasswordformostoperations.
-vp <password for encrypted virtual machine>
Guest Operations
Guestoperationsrequireauthenticationbytheguestoperatingsystem,sotheircommanddescriptionsin
Table 2,“vmrunCommandsandParameters,”onpage 11saythata“validguestlogin”isrequired.Usethe
followingflagstospecifytheguestlogin:
-gu <userName in guest OS>
-gp <userPassword in guest OS>
AsoftheVIX1.10release,younolongerneedtospecifyaguestusernameandpassword,oranencryption
password.Ifvmrunneedsauthenticationinformation,itpromptsforit.
Running Hosted Platforms Locally
OnWorkstationandVMwareFusion,vmruncontrolsguestoperatingsystemsonthelocalhost.Youdonot
needtospecifyaremotehostnameorport.Usethe-TflagforWorkstation,Player,andVMwareFusion:
vmrun -T ws
vmrun -T player
vmrun -T fusion