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

Some of the information requested on this menu applies only to Windows platforms. The Guest OS Customization panel 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 of the available 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 the 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. On the Virtual Datacenters dashboard screen, click the card of the virtual data center you want to explore and select Virtual Machines from the left panel.
  2. Click Card Icon to view the list in a card view and, optionally, filter the list of virtual machines from the Look in drop-down menu.
  3. In the card of the virtual machine you want to edit, click Details.
  4. Click Guest OS Customization and Properties to expand the list of guest operating system settings.
    Option Description
    Enable Guest Customization You can select this option to enable guest customization.
    Change SID You can select this option to change the Windows Security ID (SID).

    This option is specific for virtual machines running a Windows guest operating system. The 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 machines 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 You can select this option to require administrators to change the password of the guest operating system on the first login. This is recommended for security purposes.
    Allow local administrator password You can select this option to allow setting an administrator password on the guest operating system.
    1. Specify a password for the local administrator.

      Leaving the Specify password text box blank generates a password automatically.

    2. 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 You can select this option to join the virtual machine to a Windows domain. You can use the organization's domain or override the organization's domain and enter the domain properties.
    1. Enter the domain name.
    2. Enter the user name and password.
    3. Enter the account organizational unit.
    Script You can use a customization script to modify the guest operating system of the virtual machine. When you add a customization script to a virtual machine, the script is called only on initial customization and force recustomization. If you set the precustomization command line parameter, the script is called before guest customization begins. If you set the postcustomization command line parameter, the script is called after guest customization finishes.
    • Click the upload button below the script text box to navigate to a customization script on your local machine.
    • Type the customization script directly into the Script file text box.

    A customization script that you enter directly into the Script file text box cannot contain more than 1500 characters. For more information, see VMware Knowledge Base article

  5. Click Save once you complete making your changes.