Product Documentation

Publish to Azure RDSH

Jan 11, 2018

A Layered Image is a virtual machine that App Layering composited from the Layers and settings specified in an Image Template. You can publish one or more Layered Images to your chosen platform and use them to provision systems.


To publish Layered Images, you need one or more Image Templates.

Publish a Layered Image

To use an Image Template to publish a Layered Image

  1. In the Images module, select one or more Image Templates that you want to publish.
  2. On the Action menu, select Publish Layered Image.
  3. Make sure you are logged on to the Azure portal before continuing.
  4. On the Confirm and Complete page, select Publish Layered Images.
    For each Image Template, a task called Publishing Layered Image starts. When each task completes, the task description provides the information you need to navigate to the image in your environment.
  5. In a web browser, log on to the Azure portal and use the link in the Task description to open to the location where the image is published.
  6. In the expanded Packaging Disk Task, click the link to the session host template in the Azure portal. This opens the Microsoft Azure portal to the Custom deployment template where you can provision Azure Remote Desktop Session Hosts.

The next section explains how to complete the template to provision a session host.

Provision a Session Host

In the Custom deployment template, enter the information to provision an Azure RD Session Host.


You must manually restart all Remote Desktop Session Hosts before you can add RDS roles to Session Hosts by using PowerShell.

Check the Edit Template settings and adjust as needed.

Complete the Session Host Parameters by using the host's fully qualified domain name (FQDN).


You must include the Domain Name (not fully qualified) in the Admin User Name field in the format, mydom1\username. Also, in the Domain Name field, enter the FQDN, for example, mydom1.local.

Select the Azure Resource Group.

Specify the Resource Group Location.


Ensure that the value for the Resource group location matches the Storage account location that you configured in the Platform Connector Configuration. If the locations are not the same, the Packaging Machine will not deploy and you will have to reattempt deployment.

Review the legal terms and if you accept them, click Create.
This creates a Session Host provisioned with the Layered Image in Azure.

While Azure creates the virtual machine, you can track the progress under Virtual Machines in the hub menu.

Next Step

The next step is to power off the Session Host, power it back on, and add it to an RDS collection. For more information, see Add-RDSessionHost on the Microsoft TechNet website.