7.1

Table 2‑22. Custom Properties for Customizing Provisioned Machines with a Guest Agent (Continued)
Custom Property Description
VirtualMachine.DiskN.Label
Species the label for a machine’s disk N. The disk label
maximum is 32 characters. Disk numbering must be
sequential. When used with a guest agent, species the
label of a machine's disk N inside the guest operating
system.
VirtualMachine.DiskN.Letter
Species the drive leer or mount point of a machine’s disk
N. The default is C. For example, to specify the leer D for
Disk 1, dene the custom property as
VirtualMachine.Disk1.Letter and enter the value D.
Disk numbering must be sequential. When used in
conjunction with a guest agent, this value species the
drive leer or mount point under which an additional disk
N is mounted by the guest agent in the guest operating
system.
VirtualMachine.Admin.CustomizeGuestOSDelay
Species the time to wait after customization is complete
and before starting the guest operating system
customization. The value must be in HH:MM:SS format. If
the value is not set, the default value is one minute
(00:01:00). If you choose not to include this custom
property, provisioning can fail if the virtual machine
reboots before guest agent work items are completed,
causing provisioning to fail.
VirtualMachine.Customize.WaitComplete
Set to True to prevent the provisioning workow from
sending work items to the guest agent until all
customizations are complete.
VirtualMachine.SoftwareN.Name
Species the descriptive name of a software application N
or script to install or run during provisioning. This is an
optional and information-only property. It serves no real
function for the enhanced clone workow or the guest
agent but it is useful for a custom software selection in a
user interface or for software use reporting.
VirtualMachine.SoftwareN.ScriptPath
Species the full path to an application's install script. The
path must be a valid absolute path as seen by the guest
operating system and must include the name of the script
lename.
You can pass custom property values as parameters to the
script by inserting {CustomPropertyName} in the path string.
For example, if you have a custom property named
ActivationKey whose value is 1234, the script path is
D:\InstallApp.bat –key {ActivationKey}. The guest
agent runs the command D:\InstallApp.bat –key
1234. Your script le can then be programmed to accept
and use this value.
Insert {Owner} to pass the machine owner name to the
script.
You can also pass custom property values as parameters to
the script by inserting {YourCustomProperty} in the path
string. For example, entering the
value \\vra-
scripts.mycompany.com\scripts\changeIP.bat runs
the changeIP.bat script from a shared location, but
entering the
value \\vra-
scripts.mycompany.com\scripts\changeIP.bat
{VirtualMachine.Network0.Address} runs the
changeIP script but also passes the value of the
VirtualMachine.Network0.Address property to the
script as a parameter.
Chapter 2 Custom Properties Grouped by Function
VMware, Inc. 43