Skip to content

Commit cc1648e

Browse files
committed
Add changes in troubleshooting
1 parent aa93ba2 commit cc1648e

File tree

1 file changed

+25
-20
lines changed

1 file changed

+25
-20
lines changed

defender-endpoint/mde-plugin-wsl.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,9 @@ Be aware of the following considerations before you start:
4141

4242
3. Running a custom kernel and custom kernel command line is not supported. Although the plug-in does not block running in that configuration, it does not guarantee visibility within WSL when you're running a custom kernel and custom kernel command line. We recommend to block such configurations with help of [Microsoft Intune wsl settings](/windows/wsl/intune).
4343

44-
4. OS Distribution is displayed **None** in the **Device overview** page of a WSL device in the Microsoft Defender portal.
44+
4. The plug-in is not supported on machines with ARM64 processor.
4545

46-
5. The plug-in is not supported on machines with ARM64 processor.
47-
48-
6. The plug-in provides visibility into events from WSL, but other features like antimalware, threat and vulnerability management, and response commands are not available for the WSL logical device.
46+
5. The plug-in provides visibility into events from WSL, but other features like antimalware, threat and vulnerability management, and response commands are not available for the WSL logical device.
4947

5048
## Software prerequisites
5149

@@ -255,6 +253,15 @@ DeviceProcessEvents
255253

256254
## Troubleshooting
257255

256+
### If you see an error on launching WSL, such as "A fatal error was returned by plugin 'DefenderforEndpointPlug-in' Error code: Wsl/Service/CreateInstance/CreateVm/Plugin/ERROR_FILE_NOT_FOUND", it means the Defender for Endpoint plug-in for WSL installation is faulty. To repair it, follow these steps:
257+
258+
- In Control Panel, go to **Programs** > **Programs and Features**.
259+
260+
- Search for and select **Microsoft Defender for Endpoint plug-in for WSL**. Then select **Repair**. This action should fix the problem by placing the right files in the expected directories.
261+
262+
:::image type="content" source="media/mdeplugin-wsl/plug-in-repair-control-panel.png" alt-text="Screenshot showing MDE plug-in for WSL repair option in control panel." lightbox="media/mdeplugin-wsl/plug-in-repair-control-panel.png":::
263+
264+
258265
### The command `healthcheck.exe` shows the output, "Launch WSL distro with 'bash' command and retry in five minutes."
259266

260267
:::image type="content" source="media/mdeplugin-wsl/wsl-health-check.png" alt-text="Screenshot showing PowerShell output." lightbox="media/mdeplugin-wsl/wsl-health-check.png":::
@@ -357,7 +364,9 @@ Collect the networking logs by following these steps:
357364

358365
:::image type="content" source="media/mdeplugin-wsl/wsl-health-check-overview.png" alt-text="Screenshot showing status in PowerShell output." lightbox="media/mdeplugin-wsl/wsl-health-check-overview.png":::
359366

360-
2. Microsoft Defender Endpoint for WSL supports Linux distributions running on WSL 2. If they're associated with WSL 1, you might encounter issues. Therefore, it's advised to disable WSL 1. To do so with the Intune policy, perform the following steps:
367+
### WSL1 vs WSL2
368+
369+
- Microsoft Defender Endpoint plug-in for WSL supports Linux distributions running on WSL 2. If they're associated with WSL 1, you might encounter issues. Therefore, it's advised to disable WSL 1. To do so with the Intune policy, perform the following steps:
361370

362371
1. Go to your [Microsoft Intune admin center](https://intune.microsoft.com).
363372

@@ -369,29 +378,25 @@ Collect the networking logs by following these steps:
369378

370379
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
371380

372-
Alternately, if you want to keep using WSL 1, or not use the Intune Policy, you can selectively associate your installed distributions to run on WSL 2, by running the command in PowerShell:
381+
Alternately, if you want to keep using WSL 1, or not use the Intune Policy, you can selectively associate your installed distributions to run on WSL 2, by running the command in PowerShell:
373382

374-
```powershell
375-
wsl --set-version <YourDistroName> 2
376-
```
383+
```powershell
384+
wsl --set-version <YourDistroName> 2
385+
```
377386

378-
To have WSL 2 as your default WSL version for new distributions to be installed in the system, run the following command in PowerShell:
387+
To have WSL 2 as your default WSL version for new distributions to be installed in the system, run the following command in PowerShell:
379388

380-
```powershell
381-
wsl --set-default-version 2
382-
```
389+
```powershell
390+
wsl --set-default-version 2
391+
```
383392

384-
3. The plug-in uses the Windows EDR ring by default. If you wish to switch to an earlier ring, set `OverrideReleaseRing` to one of the following under registry and restart WSL:
393+
### Override Release ring
394+
395+
- The plug-in uses the Windows EDR ring by default. If you wish to switch to an earlier ring, set `OverrideReleaseRing` to one of the following under registry and restart WSL:
385396

386397
- **Name**: `OverrideReleaseRing`
387398
- **Type**: `REG_SZ`
388399
- **Value**: `Dogfood or External or InsiderFast or Production`
389400
- **Path**: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Defender for Endpoint plug-in for WSL`
390401

391-
4. If you see an error on launching WSL, such as "A fatal error was returned by plugin 'DefenderforEndpointPlug-in' Error code: Wsl/Service/CreateInstance/CreateVm/Plugin/ERROR_FILE_NOT_FOUND", it means the Defender for Endpoint plug-in for WSL installation is faulty. To repair it, follow these steps:
392-
393-
1. In Control Panel, go to **Programs** > **Programs and Features**.
394-
395-
2. Search for and select **Microsoft Defender for Endpoint plug-in for WSL**. Then select **Repair**. This action should fix the problem by placing the right files in the expected directories.
396402

397-
:::image type="content" source="media/mdeplugin-wsl/plug-in-repair-control-panel.png" alt-text="Screenshot showing MDE plug-in for WSL repair option in control panel." lightbox="media/mdeplugin-wsl/plug-in-repair-control-panel.png":::

0 commit comments

Comments
 (0)