You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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)
Copy file name to clipboardExpand all lines: articles/dev-box/tutorial-connect-to-dev-box-with-remote-desktop-app.md
+10-60Lines changed: 10 additions & 60 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,36 +1,33 @@
1
1
---
2
2
title: 'Tutorial: Use a Remote Desktop client to connect to a dev box'
3
3
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.
5
5
services: dev-box
6
6
ms.service: dev-box
7
7
ms.author: rosemalcolm
8
8
author: RoseHJM
9
-
ms.date: 12/15/2023
9
+
ms.date: 01/30/2024
10
10
ms.topic: tutorial
11
11
---
12
12
13
13
# Tutorial: Use a remote desktop client to connect to a dev box
14
14
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.
16
16
17
17
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.
18
18
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.
20
20
21
21
In this tutorial, you learn how to:
22
22
23
23
> [!div class="checklist"]
24
24
> * Download a remote desktop client.
25
+
> * Connect to a dev box by using a subscription URL.
25
26
> * Connect to an existing dev box.
26
-
> * Configure the remote desktop client for multiple monitors.
27
27
28
28
## Prerequisites
29
29
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.
34
31
35
32
## Download the remote desktop client and connect to your dev box
36
33
@@ -54,9 +51,9 @@ To download and set up the Remote Desktop client for Windows:
54
51
55
52
:::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.":::
56
53
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.
58
55
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.":::
60
57
61
58
1. After the Remote Desktop MSI file downloads to your computer, open the file and follow the prompts to install the Remote Desktop app.
62
59
@@ -145,55 +142,8 @@ To use a non-Windows Remote Desktop client to connect to your dev box:
145
142
1. Your dev box appears in the Remote Desktop client's **Workspaces** area. Double-click the dev box to connect.
146
143
147
144
:::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
-
149
145
---
150
146
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
-
197
147
## Clean up resources
198
148
199
149
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.
210
160
211
161
## Related content
212
162
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