When manually building a master virtual machine (VM) for your node in Microsoft Azure, you must perform several additional tasks to further configure the base VM before installing the Horizon agent and DaaS agent. You perform these steps using the Microsoft Azure portal and connecting into the new VM.


Complete the steps in Create the Virtual Machine Manually in Your Node in Microsoft Azure. If you are using a base VM that you created in Microsoft Azure outside of those documented steps, ensure your base VM meets the criteria as listed in Manually Build the Master Virtual Machine in Microsoft Azure.


Ensure that the VM was created with Storage - Use managed disk set to Yes and with the correct virtual network and subnet, as described in Manually Build the Master Virtual Machine in Microsoft Azure. Otherwise, this VM will be unusable in Horizon Cloud even after you configure it and install the agents, and then you will have to recreate it from scratch.

To verify the VM meets that criteria before you spend time configuring it, log in to the Horizon Cloud Administration Console and navigate to the Inventory VMs page to see if the VM is listed. If it is listed, then the VM meets the above criteria and you can safely proceed with further configuration.


  1. In the portal's dashboard, click the icon for the VM to open its overview page.
  2. Click Connect.

    Connect button for the base server VM in Microsoft Azure

    Depending on your browser settings, your browser downloads an RDP file or prompts you to save or run it.

  3. Use that RDP file to open a remote desktop connection to the VM.
    Use the default user name and password that you specified in the VM creation wizard. Include a backslash (\) in front of the user name to log in without a domain.

    Windows RDP login screen

  4. Click Yes to the certificate warning in the Remote Desktop Connection screen.

    Because this is the first login to the operating system, the Server Manager automatically launches to its first-time configuration wizard and also displays a Networks prompt question on the right hand side. The prompt asks about automatically finding PCs, devices, and other items on the network.

  5. Dismiss the Networks prompt on the right hand side of the screen by clicking No.
  6. In the Server Manager window's left hand bar, click Local Server to display the system properties.
  7. To temporarily enable Internet Explorer to download the agent files, turn off the IE Enhanced Security Configuration for both administrators and users.
  8. Download the Horizon View and DaaS agents' installer files to the VM from vmware.com by logging in using your My VMware account and navigating to the product's software downloads page.

    One method to download the agents' installer files is to point the VM's Internet Explorer browser to the My VMware location in vmware.com. Log in using your My VMware account. Navigate to the VMware Horizon Cloud Service on Microsoft Azure downloads page by clicking View & Download Products, navigating to the VMware Horizon Cloud Service download components page, and selecting Go to Downloads for the VMware Horizon Cloud Service on Microsoft Azure choice.

  9. Download the DaaS SSL bootstrap file from Horizon Cloud.

    This file is used in the bootstrap process that allows the VM's operating system and the Horizon Cloud node to pair with each other securely.

    1. Point the VM's browser to https://cloud.horizon.vmware.com and log in with your credentials.
    2. Click Inventory > Images.
    3. On the Images page, select ... > Download Bootstrap.
    4. In the download window, select the appropriate location, the corresponding node, and enter and re-enter a password of 8-20 ASCII characters containing at least one each of the following: lowercase letter, uppercase letter, number, and symbol (!@#$%^&*).

      Do not use non-ASCII characters in the password. Make a note of this password for future use.

    5. Click OK to save the bootstrap file to a location in the VM.

      The downloaded file is named image_bootstrap.7z by default. When you later configure the DaaS agent in the VM, this file is used as input to the Keytool.exe utility.

  10. Join the VM to the Active Directory (AD) domain that is registered with this node.
    1. Open the System Properties window from the Server Manager window's Local Server screen by clicking Workgroup.

      Workgroup link in the Local Server screen of the Server Manager

    2. In the System Properties window, click Change to change the domain.

      Arrow pointing to location of Change button in the System Properties window

    3. In the Computer Name/Domain Changes window, select the Domain radio button and enter the AD domain name that matches the one registered to the Horizon Cloud.
    4. When prompted, enter the name and password of an account with permission to join that domain and click OK.
    5. Restart the VM when prompted.
  11. Enable the Remote Desktop Server (RDS) role in the VM using the following steps.

    Enabling the RDS role allows using this server VM in RDSH farms for providing session-based desktops and remote applications.

    1. In Microsoft Azure portal, connect to the restarted VM as described in 2.
    2. Log in using an AD domain account.
    3. In the Server Manager dashboard, click Add roles and features.

      Server Manager - Add roles and features

    4. Go through the wizard steps selecting Remote Desktop Services installation, Quick Start, and Session-based desktop deployment.
    5. On the Server Selection step, retain the defaults and click Next.
    6. On the Confirmation step, select the check box to restart automatically and then click Deploy.

      Confirmation step of the RDS role enablement wizard

      The wizard starts installing the RDS deployment capabilities. The VM restarts automatically as needed.

    7. In the Microsoft Azure portal, reconnect to the restarted VM as described in 2.

      When the wizard displays the Completion step and you see the success messages, click Close to close the wizard.

What to do next

Complete the steps described in Install the VMware Agents in the RDS-Enabled Base Virtual Machine to install the agents.