Guest OS customization on vCloud Director is optional for all platforms. It is required for virtual machines that must join a Windows domain.

About this task

Some of the information requested on this menu applies only to Windows platforms. The Guest OS Customization tab includes the information necessary for the virtual machine to join a Windows domain. An organization administrator can specify default values for a domain that Windows guests in that organization can join. Not all Windows virtual machines must join a domain, but in most enterprise installations, a virtual machine that is not a domain member cannot access many network resources.


  • This operation requires the rights included in the predefined vApp Author role or an equivalent set of rights.

  • Guest customization requires the virtual machine to be running VMware Tools.

  • Before you can customize a Windows guest OS, your system administrator must install the appropriate Microsoft Sysprep files on vCloud Director server group. See the vCloud Director Installation and Upgrade Guide.

  • Customization of Linux guest operating systems requires that Perl is installed in the guest.


  1. From the Navigator, select Compute > Virtual Machines.
  2. From the Card view, click the card for the virtual machine to edit the properties of the virtual machine.
  3. Click the Guest OS Customization and Properties menu, change the properties, and click Save.



    Enable Guest Customization

    Select to enable guest customization.

    Change SID (optional)

    This option is available only for virtual machines running a Windows guest operating system. A Windows Security ID (SID) is used in some Windows operating systems to uniquely identify systems and users. If you do not select this option, the new virtual machine has the same SID as the virtual machine or template on which it is based. Duplicate SIDs do not cause problems when the computers are part of a domain and only domain user accounts are used. However, if the computers are part of a Workgroup or local user accounts are used, duplicate SIDs can compromise file access controls. For more information, see the documentation for your Microsoft Windows operating system.

    Require Administrators to change password on first login (optional)

    Select to require administrators to change password on initial login of the guest operating system. This is recommended for security purposes.

    Allow local administrator password (optional)

    Select to allow setting an administrator password on the guest operating system.

    Specify password

    Specify a password for the local administrator. Leaving this option blank will generate a password automatically.

    Number of times to log on automatically

    Specify the number of times to allow automatic login. Entering a value of zero disables automatic login as an administrator.

    Enable this VM to join a domain (optional)

    Click Enable this VM to join a domain to have the virtual machine join a Windows domain. You can use the organization's domain or override the organization's domain and enter the domain properties.

    Script (optional)

    Click the upload button to navigate to a customization script on your machine. A customization script cannot contain more than 1500 characters. You can create the script in a file on your computer, or type it directly into the Script file window. For more information, see VMware Knowledge Base article