Merge pull request #264758 from RoseHJM/mdb-rdp-split

MDB - Updates to RDP docs

Author: v-dirichards

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

@@ -44,6 +44,11 @@
       "source_path_from_root": "/articles/dev-box/monitor-reference.md",
       "redirect_url": "/azure/dev-box/monitor-dev-box-reference",
       "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/dev-box/tutorial-connect-to-dev-box-with-remote-desktop-app.md#configure-remote-desktop-to-use-multiple-monitors",
+      "redirect_url": "/azure/dev-box/tutorial-configure-multiple-monitors",
+      "redirect_document_id": false
     }
   ]
 }

articles/dev-box/index.yml

@@ -54,8 +54,10 @@ landingContent:
     linkLists:
       - linkListType: tutorial
         links:              
-          - text: Configure the Remote Desktop client to connect to a dev box with multiple monitors
+          - text: Configure the Remote Desktop client to connect to a dev box
             url: tutorial-connect-to-dev-box-with-remote-desktop-app.md
+          - text: Use multiple monitors with your dev box 
+            url: tutorial-configure-multiple-monitors.md 
       - linkListType: how-to-guide
         links:
           - text: Troubleshoot dev box connectivity issues

articles/dev-box/media/tutorial-configure-multiple-monitors/remote-desktop-app.png

@@ -56,6 +56,8 @@ items:
     href: how-to-create-dev-boxes-developer-portal.md
   - name: Connect with Remote Desktop App 
     href: tutorial-connect-to-dev-box-with-remote-desktop-app.md
+  - name: Use multiple monitors
+    href: tutorial-configure-multiple-monitors.md
   - name: Troubleshoot dev box connectivity issues
     href: how-to-troubleshoot-repair-dev-box.md
 - name: Security

articles/dev-box/media/tutorial-connect-to-dev-box-with-remote-desktop-app/remote-desktop-for-mac.png renamed to articles/dev-box/media/tutorial-configure-multiple-monitors/remote-desktop-for-mac.png

@@ -0,0 +1,93 @@
+---
+title: 'Tutorial: Configure multiple monitors for your dev box'
+titleSuffix: Microsoft Dev Box
+description: In this tutorial, you configure an RDP client to use multiple monitors when connecting to a dev box.
+services: dev-box
+ms.service: dev-box
+ms.author: rosemalcolm
+author: RoseHJM
+ms.date: 01/30/2023
+ms.topic: tutorial
+---
+
+# Tutorial: Use multiple monitors on a dev box 
+
+In this tutorial, you configure a remote desktop client to use dual or more monitors when you connect to your dev box.
+
+Using multiple monitors gives you more screen real estate to work with. You can spread your work across multiple screens, or use one screen for your development environment and another for documentation, email or messaging. 
+
+In this tutorial, you learn how to:
+
+> [!div class="checklist"]
+> * Configure the remote desktop client for multiple monitors.
+
+## Prerequisites
+
+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.
+
+## Configure Remote Desktop to use multiple monitors
+
+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.
+
+Use the following steps to configure Remote Desktop to use multiple monitors.
+
+# [Windows](#tab/windows)
+
+1. Open the Remote Desktop app. 
+ 
+   :::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.":::
+ 
+1. Right-click the dev box you want to configure, and then select **Settings**.
+ 
+1. On the settings pane, turn off **Use default settings**.
+ 
+   :::image type="content" source="media/tutorial-configure-multiple-monitors/turn-off-default-settings.png" alt-text="Screenshot showing the Use default settings slider.":::
+ 
+1. In **Display Settings**, in the **Display configuration** list, select the displays to use and configure the options:
+ 
+   | Value | Description | Options |
+   |---|---|---|
+   | 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. |
+   | 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. |
+   | 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. |
+
+   :::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.":::
+
+1. Close the settings pane, and then select your dev box to begin the Remote Desktop session.
+
+# [Non-Windows](#tab/non-Windows)
+
+1. Open Remote Desktop.
+ 
+1. Select **PCs**.
+
+1. On the Connections menu, select **Edit PC**.
+ 
+1. Select **Display**.
+ 
+1. On the Display tab, select **Use all monitors**, and then select **Save**.
+
+   :::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.":::
+
+1. Select your dev box to begin the Remote Desktop session.
+
+--- 
+
+## Clean up resources
+
+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.
+
+You can stop a dev box from the developer portal:
+
+1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
+
+1. For the dev box that you want to stop, select More options (**...**), and then select **Stop**.
+
+   :::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.":::
+
+The dev box might take a few moments to stop.
+
+## Related content
+
+- [Manage a dev box by using the developer portal](how-to-create-dev-boxes-developer-portal.md)
+- Learn how to [connect to a dev box through the browser](./quickstart-create-dev-box.md#connect-to-a-dev-box)