5.0

Table Of Contents
VMware, Inc. 29
Chapter 3 vMA Interfaces
Description
AfteraserverisaddedasavMAtarget,youmustrunvifptarget <server>beforeyourunvSphereCLI
commandsorvSphereSDKforPerlscriptsagainstthatsystem.ThesystemremainsavMAtargetacrossvMA
reboots,butrunningvifptargetagainisrequiredaftereachlogout.See“vifptargetCommandfor
vifastpass
Initialization”onpage 27.
Afteryourunvifptarget,youcanrunvSphereCLIorvSphereSDKforPerlcommandsandscriptsandyou
arenolongerpromptedforauthenticationinformation,asfollows:
IfyouaddavCenterServersystemasavMAtarget,youcanrunmostcommandsonallESXihoststhat
thevCenterServersystemmanagesusingthevSphereCLI--vihostoption.ThevSphereCLIInstallation
andReferenceGuideincludesatablethatshowswhichcommandscannottargetavCenterServer
system.
IfyouaddonlyoneESXihost,youcanruncommandswithoutspecifyingthetarget.
IfyouaddmultipleESXihosts,specifythetargettoavoidconfusion.
See“A d d TargetServerstovMA”onpage 17and“RunningvSphereCLIfortheTargetsonpage 19.
Options
Example
vifp addserver my_vCenter
AddsavCenterServersystemasavMAtarget.Youarepromptedforausernameandpassword.Theuser
musthaveloginprivilegesonthevCenterServersystem.
vifp addserver myESX42
AddsanESXihosttovifastpass.Youarepromptedfortherootpasswordforthetargetsystem.
vifp removeserver
RemovesaspecifiedvMAtargetthatwaspreviouslyaddedwithvifp addserver.
IfthetargetisanESXisystem,youneedsuperuserprivilegesforremoval.IfthetargetisavCenterServer
system,anyuserwithconnectionprivilegescanremovethetarget.Youonlyhavetospecifythe<server>
option,without
thepassword.
I
MPORTANTIfyouchangeatargetserversname,youmustremoveit,andthenaddittovMAwiththenew
name.
Option Description
server NameorIPaddressoftheESXihostorvCenterServersystemtoaddasavMAtarget.
authpolicy SetstheauthenticationpolicytofastpassauthenticationortheActiveDirectory
authentication.Thedefaultvalueisfpauth.
protocol Connectionprotocol.HTTPSbydefault.
portnumber Connectionportnumberofthetargetserver.The
defaultis443.
servicepath ServicepathURLofthetargetserver.Thedefaultis/sdk.
username Userwhoconnectstothetargetserver.
Ifthetargetserv erpointstoanESXihost,thedefaultisroot.Theusermusthave
superuserprivilegesontheESXihost.
Ifthetargetserv erpointsto
avCenterServersystem,thereisnodefault.Youare
promptedforausernameifyoudonotspecifyoneusingthisoption.Theusermusthave
privilegestoconnecttothevCenterServersystem.
password Passwordoftheuserspecifiedbyusername.