Guest OS customization on VMware Cloud 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.

Prerequisites

  • 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 VMware Cloud Director server group. See the VMware Cloud Director Installation, Configuration, and Upgrade Guide.
  • Customization of Linux guest operating systems requires that Perl is installed in the guest.

Procedure

  1. On the Virtual Data Center dashboard screen, click the card of the virtual data center you want to explore and from the left panel, select Virtual Machines.
  2. Click Card Icon to view the list in a card view and, optionally, arrange the list of virtual machines from the Sort by 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 Select this option to enable guest customization.
    Change SID 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.

    Allow local administrator password 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.

    Require Administrators to change password on first login 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.
    Auto generate password Select this option to allow password auto generation.
    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 https://kb.vmware.com/kb/1026614.

  5. Click Save once you complete making your changes.