Skip to content

Commit 2d78c2e

Browse files
authored
Merge pull request #78763 from ChJenk/mgmt
mgmt
2 parents f7e3d58 + f8a1690 commit 2d78c2e

File tree

3 files changed

+71
-1
lines changed

3 files changed

+71
-1
lines changed

articles/virtual-desktop/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@
1616
href: manage-app-groups.md
1717
- name: 5. Create a host pool to validate service updates
1818
href: create-validation-host-pool.md
19+
- name: 6. Deploy a management tool
20+
href: manage-resources-using-ui.md
1921
- name: How-to
2022
items:
2123
- name: Connect to Windows Virtual Desktop resources
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
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.

articles/virtual-desktop/troubleshoot-set-up-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ We currently aren't taking support cases while Windows Virtual Desktop is in pre
1919

2020
## Escalation tracks
2121

22-
Use the following table to identify and resolve issues you may encounter when setting up a tenant environment using Remote Desktop client.
22+
Use the following table to identify and resolve issues you may encounter when setting up a tenant environment using Remote Desktop client. Once your tenant's set up, you can use our new [Diagnostics service](https://docs.microsoft.com/azure/virtual-desktop/diagnostics-role-service) to identify issues for common scenarios.
2323

2424
>[!NOTE]
2525
>We currently aren't taking support cases while Windows Virtual Desktop is in preview. Whenever we refer to Windows Virtual Desktop support, go to our Tech Community forum for now. Visit the [Windows Virtual Desktop Tech Community](https://techcommunity.microsoft.com/t5/Windows-Virtual-Desktop/bd-p/WindowsVirtualDesktop) to discuss issues with the product team and active community members. If you need to resolve a support issue, include the activity ID and approximate time frame for when the issue occurred.

0 commit comments

Comments
 (0)