Skip to content

Commit f39d37c

Browse files
author
RoseHJM
committed
MDB - Updates to RDP docs.
1 parent cce8eb5 commit f39d37c

File tree

9 files changed

+106
-60
lines changed

9 files changed

+106
-60
lines changed

articles/dev-box/.openpublishing.redirection.dev-box.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,11 @@
3434
"source_path_from_root": "/articles/dev-box/concept-common-components.md",
3535
"redirect_url": "/azure/dev-box/overview-what-is-microsoft-dev-box#components-shared-with-azure-deployment-environments",
3636
"redirect_document_id": false
37+
},
38+
{
39+
"source_path_from_root": "/articles/dev-box/tutorial-connect-to-dev-box-with-remote-desktop-app.md#configure-remote-desktop-to-use-multiple-monitors",
40+
"redirect_url": "/azure/dev-box/tutorial-configure-multiple-monitors",
41+
"redirect_document_id": false
3742
}
3843
]
3944
}
214 KB
Loading
63 KB
Loading
1.9 KB
Loading
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: 'Tutorial: Configure multiple monitors for your dev box'
3+
titleSuffix: Microsoft Dev Box
4+
description: In this tutorial, you configure an RDP client to use multiple monitors when connecting to a dev box.
5+
services: dev-box
6+
ms.service: dev-box
7+
ms.author: rosemalcolm
8+
author: RoseHJM
9+
ms.date: 01/30/2023
10+
ms.topic: tutorial
11+
---
12+
13+
# Tutorial: Use multiple monitors on a dev box
14+
15+
In this tutorial, you configure a remote desktop client to use multiple monitors when you connect to your dev box.
16+
17+
In this tutorial, you learn how to:
18+
19+
> [!div class="checklist"]
20+
> * Configure the remote desktop client for multiple monitors.
21+
22+
## Prerequisites
23+
24+
To complete this tutorial, you must [install the Remote desktop app](tutorial-connect-to-dev-box-with-remote-desktop-app.md#download-the-remote-desktop-client-for-windows) on your local machine.
25+
26+
## Configure Remote Desktop to use multiple monitors
27+
28+
When you connect to your cloud-hosted developer machine in Microsoft Dev Box by using a remote desktop app, you can take advantage of a multi-monitor setup. Microsoft Remote Desktop for Windows and Microsoft Remote Desktop for Mac both support up to 16 monitors.
29+
30+
Use the following steps to configure Remote Desktop to use multiple monitors.
31+
32+
# [Windows](#tab/windows)
33+
34+
1. Open the Remote Desktop app.
35+
36+
:::image type="content" source="./media/tutorial-configure-multiple-monitors/remote-desktop-app.png" alt-text="Screenshot of the Windows 11 start menu with Remote desktop showing and open highlighted.":::
37+
38+
1. Right-click the dev box you want to configure, and then select **Settings**.
39+
40+
1. On the settings pane, turn off **Use default settings**.
41+
42+
:::image type="content" source="media/tutorial-configure-multiple-monitors/turn-off-default-settings.png" alt-text="Screenshot showing the Use default settings slider.":::
43+
44+
1. In **Display Settings**, in the **Display configuration** list, select the displays to use and configure the options:
45+
46+
| Value | Description | Options |
47+
|---|---|---|
48+
| All displays | Remote desktop uses all available displays. | - Use only a single display when in windowed mode. <br> - Fit the remote session to the window. |
49+
| Single display | Remote desktop uses a single display. | - Start the session in full screen mode. <br> - Fit the remote session to the window. <br> - Update the resolution on when a window is resized. |
50+
| Select displays | Remote Desktop uses only the monitors you select. | - Maximize the session to the current displays. <br> - Use only a single display when in windowed mode. <br> - Fit the remote connection session to the window. |
51+
52+
:::image type="content" source="media/tutorial-configure-multiple-monitors/remote-desktop-select-display.png" alt-text="Screenshot showing the Remote Desktop display settings, highlighting the option to select the number of displays.":::
53+
54+
1. Close the settings pane, and then select your dev box to begin the Remote Desktop session.
55+
56+
# [Non-Windows](#tab/non-Windows)
57+
58+
1. Open Remote Desktop.
59+
60+
1. Select **PCs**.
61+
62+
1. On the Connections menu, select **Edit PC**.
63+
64+
1. Select **Display**.
65+
66+
1. On the Display tab, select **Use all monitors**, and then select **Save**.
67+
68+
:::image type="content" source="media/tutorial-configure-multiple-monitors/remote-desktop-for-mac.png" alt-text="Screenshot showing the Edit PC dialog box with the display configuration options.":::
69+
70+
1. Select your dev box to begin the Remote Desktop session.
71+
72+
---
73+
74+
## Clean up resources
75+
76+
Dev boxes incur costs whenever they're running. When you finish using your dev box, shut down or stop it to avoid incurring unnecessary costs.
77+
78+
You can stop a dev box from the developer portal:
79+
80+
1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
81+
82+
1. For the dev box that you want to stop, select More options (**...**), and then select **Stop**.
83+
84+
:::image type="content" source="./media/tutorial-configure-multiple-monitors/stop-dev-box.png" alt-text="Screenshot of the menu command to stop a dev box.":::
85+
86+
The dev box might take a few moments to stop.
87+
88+
## Related content
89+
90+
- [Manage a dev box by using the developer portal](how-to-create-dev-boxes-developer-portal.md)
91+
- Learn how to [connect to a dev box through the browser](./quickstart-create-dev-box.md#connect-to-a-dev-box)

articles/dev-box/tutorial-connect-to-dev-box-with-remote-desktop-app.md

Lines changed: 10 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,33 @@
11
---
22
title: 'Tutorial: Use a Remote Desktop client to connect to a dev box'
33
titleSuffix: Microsoft Dev Box
4-
description: In this tutorial, you download and use a remote desktop client to connect to a dev box in Microsoft Dev Box. Configure the RDP client for a multi-monitor setup.
4+
description: In this tutorial, you download and use a remote desktop client to connect to a dev box in Microsoft Dev Box.
55
services: dev-box
66
ms.service: dev-box
77
ms.author: rosemalcolm
88
author: RoseHJM
9-
ms.date: 12/15/2023
9+
ms.date: 01/30/2024
1010
ms.topic: tutorial
1111
---
1212

1313
# Tutorial: Use a remote desktop client to connect to a dev box
1414

15-
In this tutorial, you download and use a remote desktop client application to connect to a dev box in Microsoft Dev Box. Learn how to configure the application to take advantage of a multi-monitor setup.
15+
In this tutorial, you download and use a remote desktop client application to connect to a dev box.
1616

1717
Remote Desktop apps let you use and control a dev box from almost any device. For your desktop or laptop, you can choose to download the Remote Desktop client for Windows Desktop or Microsoft Remote Desktop for Mac. You can also download a Remote Desktop app for your mobile device: Microsoft Remote Desktop for iOS or Microsoft Remote Desktop for Android.
1818

19-
Alternately, you can also connect to your dev box through the browser from the Microsoft Dev Box developer portal.
19+
Alternately, you can connect to your dev box through the browser from the Microsoft Dev Box developer portal.
2020

2121
In this tutorial, you learn how to:
2222

2323
> [!div class="checklist"]
2424
> * Download a remote desktop client.
25+
> * Connect to a dev box by using a subscription URL.
2526
> * Connect to an existing dev box.
26-
> * Configure the remote desktop client for multiple monitors.
2727
2828
## Prerequisites
2929

30-
To complete this tutorial, you must first:
31-
32-
- [Configure Microsoft Dev Box](./quickstart-configure-dev-box-service.md).
33-
- [Create a dev box](./quickstart-create-dev-box.md#create-a-dev-box) on the [developer portal](https://aka.ms/devbox-portal).
30+
To complete this tutorial, you must have access to a dev box through the developer portal.
3431

3532
## Download the remote desktop client and connect to your dev box
3633

@@ -54,9 +51,9 @@ To download and set up the Remote Desktop client for Windows:
5451

5552
:::image type="content" source="./media/tutorial-connect-to-dev-box-with-remote-desktop-app/connect-remote-desktop-client.png" alt-text="Screenshot that shows how to select your platform configuration for the Windows Remote Desktop client.":::
5653

57-
1. After you select your platform configuration, click the platform configuration to start the download process for the Remote Desktop client.
54+
1. After you select your platform configuration, select the platform configuration to start the download process for the Remote Desktop client.
5855

59-
:::image type="content" source="./media/tutorial-connect-to-dev-box-with-remote-desktop-app/download-windows-desktop.png" alt-text="Screenshot that shows how to click the platform configuration again to download the Windows Remote Desktop client.":::
56+
:::image type="content" source="./media/tutorial-connect-to-dev-box-with-remote-desktop-app/download-windows-desktop.png" alt-text="Screenshot that shows how to select the platform configuration again to download the Windows Remote Desktop client.":::
6057

6158
1. After the Remote Desktop MSI file downloads to your computer, open the file and follow the prompts to install the Remote Desktop app.
6259

@@ -145,55 +142,8 @@ To use a non-Windows Remote Desktop client to connect to your dev box:
145142
1. Your dev box appears in the Remote Desktop client's **Workspaces** area. Double-click the dev box to connect.
146143

147144
:::image type="content" source="./media/tutorial-connect-to-dev-box-with-remote-desktop-app/non-windows-rdp-connect-dev-box.png" alt-text="Screenshot of a dev box in a non-Windows Remote Desktop client Workspace." lightbox="./media/tutorial-connect-to-dev-box-with-remote-desktop-app/non-windows-rdp-connect-dev-box.png":::
148-
149145
---
150146

151-
## Configure Remote Desktop to use multiple monitors
152-
153-
When you connect to your cloud-hosted developer machine in Microsoft Dev Box, you can take advantage of a multi-monitor setup. Microsoft Remote Desktop for Windows and Microsoft Remote Desktop for Mac both support up to 16 monitors.
154-
155-
Use the following steps to configure Remote Desktop to use multiple monitors.
156-
157-
# [Windows](#tab/windows)
158-
159-
1. Open Remote Desktop.
160-
161-
1. Right-click the dev box you want to configure, and then select **Settings**.
162-
163-
1. On the settings pane, turn off **Use default settings**.
164-
165-
:::image type="content" source="media/tutorial-connect-to-dev-box-with-remote-desktop-app/turn-off-default-settings.png" alt-text="Screenshot showing the Use default settings slider.":::
166-
167-
1. In **Display Settings**, in the **Display configuration** list, select the displays to use and configure the options:
168-
169-
| Value | Description | Options |
170-
|---|---|---|
171-
| All displays | Remote desktop uses all available displays. | - Use only a single display when in windowed mode. <br> - Fit the remote session to the window. |
172-
| Single display | Remote desktop uses a single display. | - Start the session in full screen mode. <br> - Fit the remote session to the window. <br> - Update the resolution on when a window is resized. |
173-
| Select displays | Remote Desktop uses only the monitors you select. | - Maximize the session to the current displays. <br> - Use only a single display when in windowed mode. <br> - Fit the remote connection session to the window. |
174-
175-
:::image type="content" source="media/tutorial-connect-to-dev-box-with-remote-desktop-app/remote-desktop-select-display.png" alt-text="Screenshot showing the Remote Desktop display settings, highlighting the option to select the number of displays.":::
176-
177-
1. Close the settings pane, and then select your dev box to begin the Remote Desktop session.
178-
179-
# [Non-Windows](#tab/non-Windows)
180-
181-
1. Open Remote Desktop.
182-
183-
1. Select **PCs**.
184-
185-
1. On the Connections menu, select **Edit PC**.
186-
187-
1. Select **Display**.
188-
189-
1. On the Display tab, select **Use all monitors**, and then select **Save**.
190-
191-
:::image type="content" source="media/tutorial-connect-to-dev-box-with-remote-desktop-app/remote-desktop-for-mac.png" alt-text="Screenshot showing the Edit PC dialog box with the display configuration options.":::
192-
193-
1. Select your dev box to begin the Remote Desktop session.
194-
195-
---
196-
197147
## Clean up resources
198148

199149
Dev boxes incur costs whenever they're running. When you finish using your dev box, shut down or stop it to avoid incurring unnecessary costs.
@@ -210,5 +160,5 @@ The dev box might take a few moments to stop.
210160

211161
## Related content
212162

213-
- [Manage a dev box by using the developer portal](how-to-create-dev-boxes-developer-portal.md)
214-
- Learn how to [connect to a dev box through the browser](./quickstart-create-dev-box.md#connect-to-a-dev-box)
163+
- Learn how to [configure multiple monitors](./tutorial-configure-multiple-monitors.md) for your Remote Desktop client.
164+
- [Manage a dev box by using the developer portal](how-to-create-dev-boxes-developer-portal.md)

0 commit comments

Comments
 (0)