User/chdhan/networking doc update 2/21/24 (MicrosoftDocs#1928)

* Signed-off-by: Chanpreet Dhanjal <chdhan@microsoft.com> * updating troubleshooting page. * Updating troubleshooting guide * updating troubleshooting guide * Editorial update, added explainer * Update image alt text for accessibility --------- Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>
chjfth · Feb 22, 2024 · f74ca83 · f74ca83
1 parent e810f29
commit f74ca83
Show file tree

Hide file tree

Showing 4 changed files with 18 additions and 1 deletion.
diff --git a/WSL/media/ghost_adapter_1.png b/WSL/media/ghost_adapter_1.png
diff --git a/WSL/media/ghost_adapter_2.png b/WSL/media/ghost_adapter_2.png
diff --git a/WSL/media/ghost_adapter_3.png b/WSL/media/ghost_adapter_3.png
diff --git a/WSL/troubleshooting.md b/WSL/troubleshooting.md
@@ -1,7 +1,7 @@
 ---
 title: Troubleshooting Windows Subsystem for Linux
 description: Provides detailed information about common errors and issues people run into while running Linux on the Windows Subsystem for Linux. 
-ms.date: 11/15/2023
+ms.date: 02/22/2024
 ms.topic: article
 ---
 
@@ -436,6 +436,23 @@ This is a flaw within HNS which has been fixed with the latest Windows 11 releas
   ```Restart-Service hns```
 - When WSL is restarted, HNS will create new Firewall rules, correctly targeting the WSL interface.
 
+### Manual way to delete phantom adapters
+
+*Ghost adapters*, or phantom Plug and Play (PnP) devices, refer to hardware components that appear in your system but are not physically connected. These “ghost” devices can cause confusion and clutter in your system settings. If you see ghost adapters when running WSL in a Virtual Machine (VM), follow these manual steps to find and delete these Phantom PnP devices. Microsoft is working on an automated solution that will not require manual intervention. More information will be coming soon.
+
+1. Open Device Manager
+2. View > Show hidden devices
+
+![Screenshot of Device Manager show hidden devices menu](media/ghost_adapter_1.png)
+
+3. Open Network adapters
+
+![Screenshot of Network adapters list](media/ghost_adapter_2.png)
+
+4. Right-click over the Ghosted network adapter and select **Uninstall Device**
+
+![Screenshot of right-clicking a phantom pnp from the network list and selecting uninstall device](media/ghost_adapter_3.png)
+
 ### Starting WSL or installing a distribution returns an error code
 
 Follow the instructions to [Collect WSL logs](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md#8-detailed-logs) in the WSL repo on GitHub to collect detailed logs and file an issue on our GitHub.