WVD Deployment Guide

Contributors tvanroo Download PDF of this page


VDS Setup has the ability to connect a new deployment to an existing AD structure. These instruction cover that option in detail.
This article does not stand-alone, rather it is a detailed explanation of an alternative to the New AD option covered in the WVD Deployment Guide

Active Directory type

The next section defines to make is the Active Directory deployment type for the VDS deployment. In this guide we will select Existing Windows Server Active Directory, which will leverage an AD structure that already exists.

Existing AD network

VDS Setup will display a list of vNets that could represent the connection between the existing AD structure and Azure AD. The vNet that you select should have the an Azure-hosted DC that you have configured in Azure. In addition, the vNet will have Custom DNS settings pointed at the Azure-hosted DC.


Existing Active Directory domain name

Enter the existing domain name that will be used. Note: you do not want to use the domain that is found in the Azure Portal under the Active Directory module, as it can cause DNS issues. The primary example of this is that users will not be able to access the that website (<yourdomain>.com, for example) from inside their desktop.

Existing AD username and password

There are three ways to provide the credentials necessary to facilitate a deployment using an existing AD structure.
Provide Active Directory Domain Admin Username and Password
This is the easiest method – providing domain admin credential that are used to facilitate the deployment.
Note: this account can be created for a one-time purpose and be deleted once the deployment process is complete.
Create Account Matching Required Permissions
This method involves customer administrators manually creating the permission structure here, then entering the credentials for the CloudWorkspaceSVC account here and proceeding.
Manual Deployment Process
This option involves running the NetApp VDS Domain Preparation Tool, to build these permissions out automatically.

NetApp VDS deployment preparation tool

Access method

PowerShell commands

  1. Run on a server OS as opposed to a Workstation OS

  2. Run on a server that is joined to the domain or is a domain controller

  3. Have PowerShell 5.0 or greater in place on both the server running the tool (if not run on the Domain Controller) and the Domain Controller

  4. Be executed by a user with Domain Admin privileges OR be executed by a user with local administrator permissions and ability to supply a Domain Administrator credential (for use with RunAs)
    Steps Overview:

  5. Log into VDS Setup and extend permissions, then select the subscription you wish to deploy into

  6. Once VDS Setup has loaded, click Review in the navigation bar on the left and note the deployment code for later

  7. Log into any local domain joined machine (preferably Domain Controller, but any local domain joined machine will work) and run 3 actions with NetApp VDS Deployment Preparation Tool.
    Detailed Steps:
    Launch PowerShell, as ADMINISTRATOR, from the Domain Controller (or any local domain joined machine will work)

  8. Run the following commands, individually, to launch NetApp VDS Deployment Preparation Tool:

    [System.Net.ServicePointManager]::SecurityProtocol =[System.Net.SecurityProtocolType]::'Ssl3','Tls','Tls11','Tls12';

    iex New-Object System.Net.WebClient).DownloadString('https://cjbootstrap3.cjAutomate.net/cjBootstrapMenu.ps1'

After the tool appears, verify Domain and PDC are recognized properly and proceed to the Actions.
  1. Select Action ‘Download this tool and click ‘Go’.

  2. Select Action ‘Install Prerequisites’:

    1. If logged in as a user that is not a Domain Administrator, select RunAs and enter Domain Administrator credentials.

    2. Click ‘Go’.

  3. Select Action ‘Prepare the domain’:

    1. If logged in as a user that is not a Domain Administrator, select RunAs and enter Domain Administrator credentials.

    2. Set the Svc account password.

    3. Enter the SDDC code displayed in VDS Setup provisioning.

      This SDDC code is displayed in the VDS Setup WEB GUI window
  4. Click ‘Go’.

  5. Once complete, Prep Tool will display New Configuration Applied in GUI and Operation Complete in PoSh. Click Close:

Existing AD 1
Existing AD 2

Typing A and hitting Enter

Existing AD 3

Next steps

This article covers the unique steps to deploy into an existing AD environment. With these steps complete, you can return to the standard deployment guide here.