How To Deploy With The WVD QuickStart

On this page, the process of using the WVD QuickStart with a pre-existing Native AD or Azure AD DS setup is laid out from start to finish. The QuickStart will configure Windows Virtual Desktop using your existing setup, of which the prerequisites are outlined below. The video below shows a walkthrough of the entire deployment process, including the manual setup of a Native AD environment, should you want to create one.


In order to successfully deploy a WVD environment with the QuickStart, a couple of prerequisites need to be satisfied beforehand. All of these prerequisites are listed below, together with links to documentation that can help you with setting them up.

Additionally, the QuickStart will set up Azure DevOps for you. This is not a prerequisite that requires action from you as the user, but it’s good to be aware of the fact that this particular service will be leveraged in this automation. Once you have all of these prerequisites satisfied, this video will show you a walkthrough of the QuickStart deployment outlined below.

Get started: ARM Deployment - Azure DevOps Setup

Once you’ve satisfied all the prerequisites, you are ready to deploy using the QuickStart! As explained in the Concepts section, the deployment consists of two main components: an Azure Resource Manager (ARM) deployment and an Azure DevOps (ADO) pipeline. The first of the two will deploy a number of resources supporting the deployment automation, including the creation of a DevOps project and automation pipeline. By clicking the “Deploy to Azure” button, you will be taken to the Azure Portal for a custom deployment. There, you can fill out the required user input and click purchase. It is recommended that you create a new resource group for the QuickStart to deploy in, as this will make it easier to delete its resources.

The above button will take you to the Azure Portal, where your screen should look like the image below. To understand what input is expected for all the listed parameters, the ‘i’ balloons to the left of every parameter will give you guidance.

ARM Template

This deployment will deploy the resources outlined in the How it works section. The credentials you enter in the Portal will be securely stored as secrets in both an Azure keyvault and an Azure DevOps secret.

WVD Deployment: DevOps Pipeline

Once the ARM deployment completes, your WVD environment will automatically be deployed by an Azure DevOps pipeline. While no further action from you is required, you can follow along with this deployment, in Azure DevOps, where you will find the WVD QuickStart project. Navigate to the “pipelines” section - Here you’ll find a running pipeline that deploys a WVD environment (VMs, host pool, desktop app group, FSLogix configuration) for you. Upon completion of this pipeline, which will take about 25 minutes, your WVD environment is ready for use! You can also follow along with the deployment in the Azure Portal. Once the pipeline finished, you will receive an email from Azure DevOps (if you have supplied a notification email in the ARM deployment) informing you of its completion. Once you receive this email, your WVD environment is ready for use!

Withing Azure Devops, after clicking on your project and its pipeline, you will see something like this: DevOps Pipeline

If you click on the pipeline’s jobs, you will be able to follow along with the deployment. This will give you a sense of the progress made so far in the deployment and it will also be the place where you’ll receive your error messaging, should the deployment fail. DevOps Pipeline Progress

Using Your New WVD Environment

The QuickStart creates a test user for you to try out the environment. Navigate to the WVD web client or install the WVD client locally (from here) and login with the following test user credentials:

Username: WVDTestUser001@{your-domain}.com
Password: Taken from DevOps organization in the following way: If organization is called “WVDQuickStartOrg120011Z”, your password will be “Org120011Z!” (case sensitive, and don’t forget the exclamation point at the end) (Disclaimer: You should change this password at your earliest convenience.)

You should see a “WVD Workspace” appear, to which you can login to experience the best of Windows Virtual Desktop. Within this virtualized environment, your user will find Microsoft Office 365 amongst other built-in Microsoft applications. Additionally, since the QuickStart configures FSLogix profile management for you, a user profile will be created. This will be stored in the profiles storage account, in the wvdprofiles file share.

Deleting the WVD environment and the QuickStart resources

In case you want to delete your WVD environment and all the QuickStart resources from your Azure subscription, there’s a couple of steps to take. First, you can delete the resource group that the QuickStart was deployed in. This will delete your WVD environment and most of the QuickStart resources. Then, in the Azure portal,

Microsoft Support is not handling issues for any published tools in this repository. These tools are published as is with no implied support. However, we would like to welcome you to open issues using GitHub issues to collaborate and improve these tools. You can open an issue here.