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
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-resolve-dev-box-connectivity-issues.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,21 +33,21 @@ Any improper network configurations on your Dev Box can disrupt Remote Desktop c
33
33
Additionally, if you haven't accessed your Dev Box for some time, check whether your organization has a policy that removes users from Microsoft Entra ID due to inactivity. To regain access, contact your support team.
34
34
35
35
### Step 0: Preliminary Checks
36
-
-**Internet Connection:** Verify that your local machine has an active internet connection.
37
-
-**Dev Box Status:** Confirm that your Dev Box is running through the Dev Box portal.
38
-
-**Proxy Settings:** Incorrect internet proxy settings can interfere with the Remote Desktop experience, so ensure these settings are correctly configured.
36
+
1.**Internet Connection:** Verify that your local machine has an active internet connection.
37
+
1.**Dev Box Status:** Confirm that your Dev Box is running through the Dev Box portal.
38
+
1.**Proxy Settings:** Incorrect internet proxy settings can interfere with the Remote Desktop experience, so ensure these settings are correctly configured.
39
39
40
40
### Step 1: Windows Update and App Restart
41
-
-**Pending Updates:** If Windows is updating, it can take up to 30 minutes, during which your Dev Box won't connect.
42
-
-**Restart Remote Desktop:** Close all instances of the Remote Desktop app, terminate any 'msrdc.exe' and 'msrdcw.exe' processes via Task Manager, and then to attempt reconnection, reopen the app.
41
+
1.**Pending Updates:** If Windows is updating, it can take up to 30 minutes, during which your Dev Box won't connect.
42
+
1.**Restart Remote Desktop:** Close all instances of the Remote Desktop app, terminate any 'msrdc.exe' and 'msrdcw.exe' processes via Task Manager, and then to attempt reconnection, reopen the app.
43
43
44
44
### Step 2: Address App Hang and Authentication Issues
45
-
-**App Hang:** If the Remote Desktop app hangs, capture a process dump of MSRDC.exe and create a support request. Restart your computer and try connecting again.
46
-
-**Authentication Errors:** If denied sign-in despite correct credentials, check the join status using `dsregcmd.exe /status`. Resolve any errors with your support team and restart your computer. If authentication errors persist, unsubscribe and resubscribe to your Dev Box pool in the app.
45
+
1.**App Hang:** If the Remote Desktop app hangs, capture a process dump of MSRDC.exe and create a support request. Restart your computer and try connecting again.
46
+
1.**Authentication Errors:** If denied sign-in despite correct credentials, check the join status using `dsregcmd.exe /status`. Resolve any errors with your support team and restart your computer. If authentication errors persist, unsubscribe and resubscribe to your Dev Box pool in the app.
47
47
48
48
### Step 3: Browser Client Connection
49
-
-**Browser Access:** Attempt to connect via the browser client by visiting https://DevBox.microsoft.com and selecting "Open in browser".
50
-
-**Black Screen Issue:** If the Remote Desktop Protocol (RDP) window is black, "Shutdown" or "Stop" your Dev Box via the portal and restart it.
49
+
1.**Browser Access:** Attempt to connect via the browser client by visiting https://DevBox.microsoft.com and selecting "Open in browser".
50
+
1.**Black Screen Issue:** If the Remote Desktop Protocol (RDP) window is black, "Shutdown" or "Stop" your Dev Box via the portal and restart it.
51
51
52
52
### Step 4: Connection Drops During High CPU Load
53
53
**Registry Adjustment:** If you experience frequent connection drops with the Remote Desktop app during high CPU load, ensure your Dev Box has the latest Windows 11 build. Set the `SetGpuRealtimePriority` registry value to DWORD 2 in the Dev Box and restart.
1. Open the policy setting **Select RDP transport protocols**.
94
+
1. Set it to **Enabled**.
95
+
1. For **Select Transport Type**, select **Use only TCP**.
96
96
97
97
If the preceding steps don't resolve your issue, contact your support team.
98
98
@@ -103,11 +103,11 @@ Include the following details in your incident report:
103
103
- A detailed description of the problem
104
104
- The Activity ID from your Remote Desktop session, if available. You can find this ID by clicking on the connection bar during your session.
105
105
106
-
:::image type="content" source="media/how-to-resolve-dev-box-connectivity-issues/troubleshooting-connection-bar.png" alt-text="Screenshot of the Remote Desktop connection bar.":::
106
+
:::image type="content" source="media/how-to-resolve-dev-box-connectivity-issues/troubleshooting-connection-bar.png" alt-text="Screenshot that shows the Remote Desktop connection bar.":::
107
107
108
108
- Include information from the connection dialog.
109
109
110
-
:::image type="content" source="media/how-to-resolve-dev-box-connectivity-issues/troubleshooting-connection-information-dialog.png" alt-text="Troubleshooting connection information dialog for resolving Dev Box connectivity issues.":::
110
+
:::image type="content" source="media/how-to-resolve-dev-box-connectivity-issues/troubleshooting-connection-information-dialog.png" alt-text="Screenshot that shows the Troubleshooting connection information dialog box.":::
111
111
112
112
In macOS clients, use the terminal to change connections to TCP instead of UDP:
0 commit comments