Tenant administrators and business group managers can use custom properties to configure RDP settings.

About this task


If your fabric administrator creates a build profile that contains the required custom properties and you include it in your blueprint, you do not need to individually add the required custom properties to the blueprint.


  • Log in to the vRealize Automation console as a tenant administrator or business group manager.

  • Create at least one blueprint.


  1. Select Infrastructure > Blueprints > Blueprints.
  2. Point to the blueprint to change and click Edit.
  3. Click the Properties tab.
  4. (Optional) Select one or more build profiles from the Build profiles menu.

    Build profiles contain groups of custom properties. Fabric administrators can create build profiles.

  5. Configure RDP settings.
    1. Click New Property.
    2. Enter the RDP custom property names in the Name text box and the corresponding values in the Value text box.


      Description and Value

      (Required for RDP customization)RDP.File.Name

      Specifies an RDP file from which to obtain settings, for example My_RDP_Settings.rdp. The file must reside in the Website\Rdp subdirectory of the vRealize Automation installation directory.

      (Required for RDP customization)


      Configures specific RDP settings. N is a unique number used to distinguish one RDP setting from another. For example, to specify the Authentication Level so that no authentication requirement is specified, define the custom property VirtualMachine.Rdp.Setting1 and set the value to authentication level:i:3. Use to open an RDP link to specify settings.

      For a list of available settings and correct syntax, see the Microsoft Windows RDP documentation.


      Specifies the domain name to include in the fully qualified domain name of the machine that the RDP or SSH files generate for the user interface options Connect Using RDP or Connect Using SSH option. For example, set the value to myCompany.com to generate the fully qualified domain name my-machine-name.myCompany.com in the RDP or SSH file.

    3. (Optional) Select the Encrypted check box to encrypt the custom property in the database.
    4. (Optional) Select the Prompt user check box to require the user to provide a value when they request a machine.

      If you choose to prompt users for a value, any value you provide for the custom property is presented to them as the default. If you do not provide a default, users cannot continue with the machine request until they provide a value for the custom property.

    5. Click the Save icon (Save).
  6. Click OK.

What to do next

Enable Connections Using RDP.