Merge pull request #291157 from RoseHJM/mdb-troubleshooting-articles

MDB -  troubleshooting articles

Author: denrea

articles/dev-box/how-to-resolve-dev-box-connectivity-issues.md

@@ -0,0 +1,127 @@
+---  
+title: Resolve Dev Box connectivity issues    
+description: Learn how to resolve connection issues with dev boxes, including disconnections and sign-in problems, to maintain a stable workflow.
+author: RoseHJM    
+ms.author: rosemalcolm  
+ms.service: dev-box    
+ms.topic: troubleshooting-general    
+ms.date: 10/22/2024
+  
+#customer intent: As a developer, I want to troubleshoot my Remote Desktop connection issues with dev boxes so that I can maintain a stable and efficient workflow.    
+---  
+  
+# Resolve connectivity issues with dev boxes  
+  
+If you're experiencing problems with your Remote Desktop connection to your dev box, this guide can help you find and fix the issues quickly. Whether it's frequent disconnections, latency, or sign-in problems, we've got solutions that can get you back on track.  
+  
+## Prerequisites  
+  
+Before you begin troubleshooting, ensure you have:  
+  
+- Access to your dev box.  
+- Administrative permissions if needed.  
+- An understanding of your organization's policies related to dev boxes.  
+
+## Steps for troubleshooting 
+  
+Remote Desktop connections are essential for accessing your Dev Box. However, connectivity issues can sometimes arise due to various factors. This guide provides a comprehensive step-by-step approach to troubleshooting common Remote Desktop connection problems, ensuring that your workflow remains uninterrupted.
+ 
+Before proceeding with troubleshooting, ensure that your Remote Desktop app is updated and both your client computer, and Dev Box have the latest updates installed. 
+
+Any improper network configurations on your Dev Box can disrupt Remote Desktop connections. 
+
+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.
+
+### Step 0: Preliminary Checks
+1. **Internet Connection:** Verify that your local machine has an active internet connection.
+1. **Dev Box Status:** Confirm that your Dev Box is running through the Dev Box portal.
+1. **Proxy Settings:** Incorrect internet proxy settings can interfere with the Remote Desktop experience, so ensure these settings are correctly configured.
+
+### Step 1: Windows Update and App Restart
+1. **Pending Updates:** If Windows is updating, it can take up to 30 minutes, during which your Dev Box won't connect.
+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.
+
+### Step 2: Address App Hang and Authentication Issues
+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.
+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. 
+
+### Step 3: Browser Client Connection
+1. **Browser Access:** Attempt to connect via the browser client by visiting https://DevBox.microsoft.com and selecting "Open in browser".
+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.
+
+### Step 4: Connection Drops During High CPU Load
+**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.
+
+```
+key: HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations
+value name: SetGpuRealtimePriority
+value: DWORD 2
+```
+
+You can set the `SetGpuRealtimePriority` registry value by using this command in an elevated shell:
+
+```
+reg add "HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" /v SetGpuRealtimePriority /d 2 /t REG_DWORD
+```  
+
+### Step 5: Connection Drops During Low CPU Usage
+
+If you experience frequent connection drops with the Remote Desktop app despite low CPU usage on the Dev Box, switch Remote Desktop to use TCP instead of UDP. 
+
+You can configure this setting through a registry edit, or through Group Policy. 
+
+#### Use TCP instead of UDP - Registry edit:
+Close the Remote Desktop app, apply the following registry setting on your client computer, and try reconnecting.
+
+```
+key: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client
+value name: fClientDisableUDP
+value: DWORD 1
+```
+
+You can set the `fClientDisableUDP` registry value by using this command in an elevated shell:
+
+```
+reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client" /v fClientDisableUDP /d 1 /t REG_DWORD
+```
+
+#### Use TCP instead of UDP - Group policy:
+Alternatively, use Group Policy Editor on your Dev Box to set RDP transport protocols to "Use only TCP".
+
+1. Open the Group Policy Editor on your Dev Box.
+1. Navigate to **Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Connections**.
+1. Open the policy setting **Select RDP transport protocols**.
+1. Set it to **Enabled**.
+1. For **Select Transport Type**, select **Use only TCP**.
+
+If the preceding steps don't resolve your issue, contact your support team. 
+
+Include the following details in your incident report:
+
+- The time the issue occurred
+- Impacted users
+- A detailed description of the problem
+- The Activity ID from your Remote Desktop session, if available. You can find this ID by clicking on the connection bar during your session.
+
+   :::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.":::
+
+- Include information from the connection dialog.
+ 
+   :::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.":::
+
+In macOS clients, use the terminal to change connections to TCP instead of UDP:
+
+In the app:
+```
+defaults write com.microsoft.rdc.macos ClientSettings.EnableAvdUdpSideTransport false
+```
+
+In the beta app:
+```
+defaults write com.microsoft.rdc.osx.beta ClientSettings.EnableAvdUdpSideTransport false
+```
+
+
+## Related content
+- [Troubleshoot and resolve dev box Remote Desktop connectivity issues](how-to-troubleshoot-repair-dev-box.md)
+- [Get support for Microsoft Dev Box](how-to-get-help.md)

articles/dev-box/how-to-troubleshoot-remote-desktop-connectivity.md

@@ -0,0 +1,66 @@
+---  
+title: Troubleshoot known Dev Box Remote Desktop issues    
+description: Learn how to troubleshoot known Remote Desktop connection issues with dev doxes to maintain a stable workflow.
+author: RoseHJM    
+ms.author: rosemalcolm  
+ms.service: dev-box    
+ms.topic: troubleshooting-general    
+ms.date: 10/22/2024
+  
+#customer intent: As a developer, I want to troubleshoot my Remote Desktop connection issues with dev boxes so that I can maintain a stable and efficient workflow.    
+---  
+  
+# Troubleshoot known Remote Desktop connectivity issues with dev boxes  
+  
+If you're experiencing problems with your Remote Desktop connection to your dev box, this guide can help you find and fix the issues quickly. Whether it's frequent disconnections, latency, or sign-in problems, we've got solutions that can get you back on track.  
+  
+## Prerequisites  
+  
+Before you begin troubleshooting, ensure you have:  
+  
+- Access to your dev box.  
+- Administrative permissions if needed.  
+- An understanding of your organization's policies related to dev boxes.  
+  
+## Does your Remote Desktop session disconnect frequently?
+Organizations can set a policy that disconnects dev boxes after a specified length of time. 
+
+## You see a window pop-up with message "You were disconnected from \<dev-box-name\> because your session was locked." 
+You might see this message if your organization sets a policy to disconnect idle dev boxes after a specified length of time, and has the single-sign on (SSO) feature enabled. Select **Reconnect** to access your dev box again. 
+
+## My dev box is stuck at sign-in welcome screen when I try to reconnect after dev box is locked due to being idle. 
+You might have to close the remote desktop session and connect again. 
+
+## Does your Remote Desktop session have a higher network latency and feel laggy? 
+If you're using a VPN on your client computer or dev box, you might experience network latency. A forced-tunnel VPN, which routes all IP addresses, can increase this latency. Check with your network administrator.
+
+## I can't enable the Windows insider channel in my dev box.
+Enabling Windows insider channel in your dev box isn't supported. Upgrading your dev box to a Windows insider build might result in unable to connect to your dev box. 
+
+## Windows update is taking a long time to install.
+Windows update might take 30 minutes or more to install. If you can't connect to your dev box immediately after Windows update, retry after 15 – 30 minutes. 
+
+## I disabled the network connection in my dev box and unable to connect.
+If you disabled the network connection in your dev box and are unable to connect, wait for up to 4 hours and retry. Our agent periodically checks and re-enable it every 4 hours. 
+
+## Teams calls don't work well in my dev box.
+If Teams calls don't work well in your dev box, open the About page in Teams and check that the **AVD Media Optimized** feature is installed. If this feature isn't installed, or if your dev box is running Windows Enterprise N or KN SKUs, contact your dev box administrator.  
+
+## I can't connect to my dev box from my client computer.
+If CPU profiling doesn't work on an AMD-based dev box, it's a known Windows issue. To fix it, go to **Turn Windows features on or off,** uninstall **Hyper-V** and **Virtual Machine Platform,** and reboot.
+
+## Do an AMD-based dev box support nested virtualization?
+AMD-based dev boxes don't support Hyper-V VMs with nested virtualization. After setting `Set-VMProcessor -VMName <name> -ExposeVirtualizationExtensions $true`, VMs inside dev box won't boot. To avoid this issue, use Intel based dev box. 
+
+## When I try to sign in to dev box by using Windows Hello for Business based authentication, I get error code 0x8007013d.
+When you sign in to dev box via Windows Hello for Business based authentication method and it fails with error code 0x8007013d, it could be due to Windows Hello certificate not properly installed. To fix it, first make sure you remember your password. Run `certutil -DeleteHelloContainer` command on your client computer (not your dev box), sign out and log back in. 
+
+## My dev box has display issues. 
+If you notice display issues like incorrect window scaling, blurry content, or broken screen paint, it might be due to a screen DPI rendering issue. These issues usually happen when using multiple monitors or switching between different physical machines. To fix it, disconnect and reconnect the dev box.
+
+## My Remote Desktop connection is reporting UDP issues.
+If UDP port 3478 is blocked in your network (for example, on your home router), your Remote Desktop connection might have problems using UDP. For the best experience, keep UDP port 3478 open.   
+
+## Related content  
+  
+- [Troubleshoot and resolve dev box Remote Desktop connectivity issues](how-to-troubleshoot-repair-dev-box.md)

articles/dev-box/how-to-troubleshoot-repair-dev-box.md

@@ -1,18 +1,18 @@
 ---
-title: Troubleshoot and repair Remote Desktop connectivity issues 
+title: Resolve connectivity issues with Troubleshoot and Repair
 description: Having problems connecting to your dev box remotely? Learn how to troubleshoot and resolve connectivity issues to your dev box with developer portal tools. 
 author: RoseHJM 
 ms.author: rosemalcolm 
 ms.service: dev-box 
 ms.topic: troubleshooting 
 ms.date: 01/10/2024
 
-#CustomerIntent: As a dev box user, I want to be able to troubleshoot and repair connectivity issues with my dev box so that I don't lose development time.
+#CustomerIntent: As a dev box user, I want to be able to automatically troubleshoot and repair connectivity issues with my dev box so that I don't lose development time.
 ---
 
-# Troubleshoot and resolve dev box Remote Desktop connectivity issues 
+# Resolve connectivity issues with the Troubleshoot and Repair tool 
 
-In this article, you learn how to troubleshoot and resolve Remote Desktop Connectivity (RDC) issues with your dev box. Because RDC issues to your dev box can be time consuming to resolve manually, use the **Troubleshoot & repair** tool in the developer portal to diagnose and repair some common dev box connectivity issues.
+In this article, you learn how to troubleshoot and resolve Remote Desktop Connectivity (RDC) issues with your dev box by using the Troubleshoot and Repair tool. Because RDC issues to your dev box can be time consuming to resolve manually, use the **Troubleshoot & repair** tool in the developer portal to diagnose and repair some common dev box connectivity issues.
 
 :::image type="content" source="media/how-to-troubleshoot-repair-dev-box/dev-box-troubleshoot-repair-tool.png" alt-text="Screenshot showing the Troubleshoot and repair tool in the Microsoft developer portal." lightbox="media/how-to-troubleshoot-repair-dev-box/dev-box-troubleshoot-repair-tool.png":::
 

articles/dev-box/index.yml

@@ -70,8 +70,10 @@ landingContent:
             url: tutorial-configure-multiple-monitors.md 
       - linkListType: how-to-guide
         links:
+          - text: Use the Troubleshoot and Repair tool
+            url: how-to-troubleshoot-repair-dev-box.md
           - text: Troubleshoot dev box connectivity issues
-            url: how-to-troubleshoot-repair-dev-box.md      
+            url: how-to-troubleshoot-remote-desktop-connectivity.md                   
 
   # Card
   - title: Provide secure access

articles/dev-box/media/how-to-resolve-dev-box-connectivity-issues/troubleshooting-connection-bar.png

@@ -123,8 +123,15 @@ items:
     href: how-to-skip-delay-stop.md
 - name: Troubleshooting
   items: 
-  - name: Troubleshoot dev box connectivity issues
+  - name: Automatically repair connectivity issues
+    displayName: Troubleshoot & repair, troubleshooter, fix, wizard  
     href: how-to-troubleshoot-repair-dev-box.md
+  - name: Troubleshoot dev box connectivity issues
+    displayName: Troubleshoot & repair, troubleshooter, fix
+    href: how-to-troubleshoot-remote-desktop-connectivity.md
+  - name: Resolve dev box connectivity issues
+    displayName: Troubleshoot & repair, troubleshooter, fix
+    href: how-to-resolve-dev-box-connectivity-issues.md
   - name: Troubleshoot Task view issues
     href: how-to-troubleshoot-dev-box-task-view.md
   - name: Get support for Microsoft Dev Box