2.0

Table Of Contents
VMware ACE Administrator’s Manual
158 VMware, Inc.
Policyupdatestakeeffectwhiletheinstanceisrunning,withtheseexceptions:
AuthenticationpoliciesUserandgrouplists,passwords,andscriptscanbe
updated.Changestakeeffectthenexttimetheinstanceispoweredon.
PolicyupdatefrequencypoliciesIfPolicyUpdateFrequencyissettoOnly
whentheACEinstancepowerson,changestakeeffectthenexttimetheinstance
ispoweredon.
Writing Plug-In Policy Scripts
YoumaywriteyourownscriptstocontrolcertainpoliciesinVMwarePlayer.Youmay
useanylanguagethatissupportedontheuserscomputer.
Forsecurityreasons,scriptsmustbedeployedaspartofapackageandinstalledbythe
packageinstaller.Theycannotbedeployedseparatelytousersʹcomputers
andcannot
bemodifiedbytheenduser.
YourscriptsmustwritetheappropriatevaluestoStdOut.OutputtoStdOutmaybeup
to4096byteslong.
PlaceanyscriptsyouwanttouseforapackageintheACE Resourcesdirectory.They
mustbeinthemainACE Resourcesdirectory,notina
subdirectoryunderthatfolder.
Ifthescriptsneedanyadditionalresourcefiles,placethosefilesinthemainACE
Resourcesfolder ,too.Yourscriptshouldreferencethoseresourcesusingrelative
paths.
YourscriptsmayalsowritemessagestoStdErr.OutputtoStdErrmaybeupto4096
byteslong.Anymessagesgeneratedon
StdErrarecapturedinthelogfileontheend
usersmachineat<UserAppData>\VMware\VMware ACE\<package_name>\Virtual
Machines\<VM_name>\vmware.log.
Theexitcodeofascriptindicateswhetherthescriptsucceededorfailed.
Table61describestheenvironmentvariablesthataresetinthescriptexecution
environment.
Table 6-1. Environment Variables
Variable Description
VMWARE_EXPIRE_TIME Thisisthetimeatwhichthisvirtualmachinewillexpire.If
setto‐1,itmeansneverexpire;ifsetto0,itmeansexpired.
VMWARE_PROJ_ID TheIDoftheprojecttowhichthisvirtualmachinebelongs.
VMWARE_MVM_ID TheIDofthisvirtualmachine.ThevirtualmachineIDis
unique
withinaproject.