|
| 1 | +--- |
| 2 | +title: Deploy management tool - Azure |
| 3 | +description: How to install a user interface tool to manage Windows Virtual Desktop preview resources. |
| 4 | +services: virtual-desktop |
| 5 | +author: ChJenk |
| 6 | + |
| 7 | +ms.service: virtual-desktop |
| 8 | +ms.topic: tutorial |
| 9 | +ms.date: 06/04/2019 |
| 10 | +ms.author: v-chjenk |
| 11 | +--- |
| 12 | +# Tutorial: Deploy a management tool |
| 13 | + |
| 14 | +The management tool provides a user interface (UI) for managing Microsoft Virtual Desktop Preview resources. In this tutorial, you'll learn how to deploy and connect to the management tool. |
| 15 | + |
| 16 | +>[!NOTE] |
| 17 | +>These instructions are for a Windows Virtual Desktop Preview-specific configuration that can be used with your organization's existing processes. |
| 18 | +
|
| 19 | +## Important considerations |
| 20 | + |
| 21 | +Since the app requires consent to interact with Windows Virtual Desktop, this tool doesn't support Business-to-Business (B2B) scenarios. Each Azure Active Directory (AAD) tenant's subscription will need its own separate deployment of the management tool. |
| 22 | + |
| 23 | +This management tool is a sample. Microsoft will provide important security and quality updates. The [source code is available in GitHub](https://github.com/Azure/RDS-Templates/tree/master/wvd-templates/wvd-management-ux/deploy). Customers and partners are encouraged to customize the tool to fit their business needs. |
| 24 | + |
| 25 | +## What you need to run the Azure Resource Manager template |
| 26 | + |
| 27 | +Before deploying the Azure Resource Manager template, you'll need an Azure Active Directory user account that: |
| 28 | + |
| 29 | +- Has Azure Multi-Factor Authentication (MFA) disabled |
| 30 | +- Has permission to create resources in your Azure subscription |
| 31 | +- Has permissions to read your Windows Virtual Desktop tenant |
| 32 | + |
| 33 | +## Run the Azure Resource Manager template to provision the management UI |
| 34 | + |
| 35 | +Before you start, ensure the server and client apps have consent by visiting the [Windows Virtual Desktop Consent Page](https://rdweb.wvd.microsoft.com) for the Azure Active Directory (AAD) represented. |
| 36 | + |
| 37 | +Follow these instructions to deploy the Azure Resource Management template: |
| 38 | + |
| 39 | +1. Go to the [GitHub Azure RDS-Templates page](https://github.com/Azure/RDS-Templates/tree/master/wvd-templates/wvd-management-ux/deploy). |
| 40 | +2. Deploy the template to Azure. |
| 41 | + - If you're deploying in an Enterprise subscription, scroll down and select **Deploy to Azure**. See [Guidance for template parameters](#guidance-for-template-parameters). |
| 42 | + - If you're deploying in a Cloud Solution Provider subscription, follow these instructions to deploy to Azure: |
| 43 | + 1. Scroll down and right-click **Deploy to Azure**, then select **Copy Link Location**. |
| 44 | + 2. Open a text editor like Notepad and paste the link there. |
| 45 | + 3. Right after <https://portal.azure.com/> and before the hashtag (#), enter an at sign (@) followed by the tenant domain name. Here's an example of the format: <https://portal.azure.com/@Contoso.onmicrosoft.com#create/>. |
| 46 | + 4. Sign in to the Azure portal as a user with Admin/Contributor permissions to the Cloud Solution Provider subscription. |
| 47 | + 5. Paste the link you copied to the text editor into the address bar. |
| 48 | + |
| 49 | +### Guidance for template parameters |
| 50 | +Here's how to enter parameters for configuring the tool: |
| 51 | + |
| 52 | +- This is the RD broker URL: <https://rdbroker.wvd.microsoft.com/> |
| 53 | +- This is the resource URL: <https://mrs-prod.ame.gbl/mrs-RDInfra-prod> |
| 54 | +- Use your AAD credentials with MFA disabled to sign in to Azure. See [What you need to run the Azure Resource Manager template](#what-you-need-to-run-the-azure-resource-manager-template). |
| 55 | +- Use a unique name for the application that will be registered in your Azure Active Directory for the management tool; for example, Apr3UX. |
| 56 | + |
| 57 | +## Use the management tool |
| 58 | + |
| 59 | +After the GitHub Azure Resource Manager template completes, you'll find a resource group containing two app services along with one app service plan in the Azure portal. |
| 60 | + |
| 61 | +Follow these instructions to launch the tool: |
| 62 | + |
| 63 | +1. Select the Azure App Services resource with the name you provided in the template (for example, Apr3UX) and navigate to the URL associated with it; for example, <https://rdmimgmtweb-210520190304.azurewebsites.net>. |
| 64 | +2. Sign in using your Windows Virtual Desktop credentials. |
| 65 | +3. When prompted to choose a Tenant Group, select **Default Tenant Group** from the drop-down list. |
| 66 | + |
| 67 | +> [!NOTE] |
| 68 | +> If you have a custom Tenant Group, enter the name manually instead of choosing from the drop-down list. |
0 commit comments