diff --git a/WSL/media/ghost_adapter_1.png b/WSL/media/ghost_adapter_1.png new file mode 100644 index 00000000..aac4f98a Binary files /dev/null and b/WSL/media/ghost_adapter_1.png differ diff --git a/WSL/media/ghost_adapter_2.png b/WSL/media/ghost_adapter_2.png new file mode 100644 index 00000000..5ad8aa6f Binary files /dev/null and b/WSL/media/ghost_adapter_2.png differ diff --git a/WSL/media/ghost_adapter_3.png b/WSL/media/ghost_adapter_3.png new file mode 100644 index 00000000..72c13e89 Binary files /dev/null and b/WSL/media/ghost_adapter_3.png differ diff --git a/WSL/troubleshooting.md b/WSL/troubleshooting.md index 37b205b6..cbaba576 100644 --- 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.