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: defender-endpoint/mde-plugin-wsl.md
+25-20Lines changed: 25 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,11 +41,9 @@ Be aware of the following considerations before you start:
41
41
42
42
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).
43
43
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.
45
45
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.
49
47
50
48
## Software prerequisites
51
49
@@ -255,6 +253,15 @@ DeviceProcessEvents
255
253
256
254
## Troubleshooting
257
255
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
+
258
265
### The command `healthcheck.exe` shows the output, "Launch WSL distro with 'bash' command and retry in five minutes."
@@ -357,7 +364,9 @@ Collect the networking logs by following these steps:
357
364
358
365
:::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":::
359
366
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:
361
370
362
371
1. Go to your [Microsoft Intune admin center](https://intune.microsoft.com).
363
372
@@ -369,29 +378,25 @@ Collect the networking logs by following these steps:
369
378
370
379
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
371
380
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:
373
382
374
-
```powershell
375
-
wsl --set-version <YourDistroName> 2
376
-
```
383
+
```powershell
384
+
wsl --set-version <YourDistroName> 2
385
+
```
377
386
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:
379
388
380
-
```powershell
381
-
wsl --set-default-version 2
382
-
```
389
+
```powershell
390
+
wsl --set-default-version 2
391
+
```
383
392
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:
385
396
386
397
-**Name**: `OverrideReleaseRing`
387
398
-**Type**: `REG_SZ`
388
399
-**Value**: `Dogfood or External or InsiderFast or Production`
389
400
-**Path**: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft Defender for Endpoint plug-in for WSL`
390
401
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.
396
402
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