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

Some of the information requested on this tab applies only to Windows platforms. The Guest OS Customization tab includes the information necessary for the VM 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 VMs must join a domain, but in most enterprise installations, a VM that is not a domain member cannot access many network resources. For more information, see Understanding Guest Customization.


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

  • Guest customization requires the VM 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. Click My Cloud.
  2. In the left pane, click VMs.
  3. Select a virtual machine, right-click, and select Properties.
  4. Click the Guest OS Customization tab and select Enable guest customization.
  5. (Optional) Select Change SID to change the Windows SID of the VM at deployment.
    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.
  6. (Optional) Select Allow local administrator password to allow setting an administrator password on the guest operating system.
    Option Description
    Auto generate password vCloud Director generates an administrator password for the guest operating system.
    Specify password Type an administrator password for the guest operating system.
    Select Automatically log on as Administrator to configure the VM to automatically log users in to the local administrator account. This option can be useful f you restart the guest operating system frequently and want to avoid entering your login credentials or you want to grant users access to the guest operating system without sharing the local administrator password.
  7. (Optional) Select Require administrator to change password on first login to require the administrator to change this password the first time they log in to the guest operating system.
  8. (Optional) Click Enable this VM to join a domain and type domain properties to have the virtual machine join a Windows domain.
    You must select Change SID in Step 5 to enable the VM to join a domain.
    Option Description
    Use organization's domain The VM joins the domain configured by your organization administrator. You do not need to supply any more information.
    Override organization's domain The VM joins another domain. You must supply the domain name, domain administrator password, and account organizational unit. Syntax for the organizational unit varies with the domain. Ask your domain administrator.
  9. (Optional) Upload a guest customization script.
    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 window. For more information, see VMware Knowledge Base article
    Option Description
    Script file Click Browse, navigate to a customization script on your computer. When you select a file, the contents appear in the Script window. You can edit them in that window if you want to.
    Script Type the script in the Script window.
  10. Click OK to save your changes.