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
+16-19
Original file line number
Diff line number
Diff line change
@@ -35,21 +35,19 @@ Windows Subsystem for Linux (WSL) 2, which replaces the previous version of WSL
35
35
36
36
Be aware of the following considerations before you start:
37
37
38
-
1. The plug-in doesn't support automatic updates on versions prior to `1.24.522.2`. On version `1.24.522.2` and later, updates are supported through Windows Update across all rings. Updates through Windows Server Update services (WSUS), System Center Configuration Manager (SCCM) and Microsoft Update catalog are supported only in the Production ring to ensure package stability.
38
+
- The plug-in doesn't support automatic updates on versions prior to `1.24.522.2`. On version `1.24.522.2` and later. Updates are supported through Windows Update across all rings. Updates through Windows Server Update Services (WSUS), System Center Configuration Manager (SCCM), and Microsoft Update catalog are supported only in the Production ring to ensure package stability.
39
39
40
-
2. It takes a few minutes for the plug-in to fully instantiate, and up to 30 minutes for a WSL2 instance to onboard itself. Short-lived WSL container instances might result in the WSL2 instance not showing up in the Microsoft Defender portal ([https://security.microsoft.com](https://security.microsoft.com)). Once any distribution has been running long enough (at least 30 minutes), it does show up.
40
+
- It takes a few minutes for the plug-in to fully instantiate, and up to 30 minutes for a WSL2 instance to onboard itself. Short-lived WSL container instances might result in the WSL2 instance not showing up in the Microsoft Defender portal ([https://security.microsoft.com](https://security.microsoft.com)). When any distribution has been running long enough (at least 30 minutes), it does show up.
41
41
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).
42
+
- 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 blocking such configurations with [Microsoft Intune wsl settings](/windows/wsl/intune).
43
43
44
-
4. The plug-in is not supported on machines with ARM64 processor.
44
+
- The plug-in is not supported on machines with an ARM64 processor.
45
45
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.
46
+
- 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.
47
47
48
48
## Software prerequisites
49
49
50
-
- WSL version 2.0.7.0 or later must be running with at least one active distro.
51
-
52
-
Run `wsl --update` to make sure you are on the latest version. If `wsl -–version` shows a version older than `2.0.7.0`, run `wsl -–update –pre-release` to get the latest update.
50
+
- WSL version `2.0.7.0` or later must be running with at least one active distro. Run `wsl --update` to make sure you are on the latest version. If `wsl -–version` shows a version older than `2.0.7.0`, run `wsl -–update –pre-release` to get the latest update.
53
51
54
52
- The Windows client device must be onboarded to Defender for Endpoint.
55
53
@@ -142,9 +140,9 @@ For example, if your host machine has both `Winhttp proxy` and `Network & Intern
142
140
> [!NOTE]
143
141
> The `DefenderProxyServer` registry key is no longer supported. Follow the steps described earlier in this article to configure proxy in plug-in.
144
142
145
-
## Connectivity test for Defender running in WSL
143
+
## Connectivity test for Defender for Endpoint running in WSL
146
144
147
-
The defender connectivity test is triggered whenever there is a proxy modification on your device and is scheduled to run every hour.
145
+
The Defender for Endpoint connectivity test is triggered whenever there is a proxy modification on your device and is scheduled to run every hour.
148
146
149
147
On starting your wsl machine, wait for 5 minutes and then run `healthcheck.exe` (located at `%ProgramFiles%\Microsoft Defender for Endpoint plug-in for WSL\tools` for the results of the connectivity test). If successful, you can see that the connectivity test was a success. If failed, you can see that the connectivity test was `invalid` indicating that the client connectivity from MDE plug-in for WSL to Defender for Endpoint service URLs is failing.
150
148
@@ -258,12 +256,11 @@ DeviceProcessEvents
258
256
259
257
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:
260
258
261
-
- In Control Panel, go to **Programs** > **Programs and Features**.
262
-
263
-
- 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.
259
+
1. In Control Panel, go to **Programs** > **Programs and Features**.
264
260
265
-
:::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":::
261
+
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.
266
262
263
+
:::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":::
267
264
268
265
### The command `healthcheck.exe` shows the output, "Launch WSL distro with 'bash' command and retry in five minutes."
269
266
@@ -371,15 +368,15 @@ Collect the networking logs by following these steps:
371
368
372
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:
373
370
374
-
1. Go to your [Microsoft Intune admin center](https://intune.microsoft.com).
371
+
1. Go to your [Microsoft Intune admin center](https://intune.microsoft.com).
375
372
376
-
2. Go to **Devices** > **Configuration Profiles** > **Create** > **New Policy**.
373
+
2. Go to **Devices** > **Configuration Profiles** > **Create** > **New Policy**.
377
374
378
-
3. Select **Windows 10 and later** > **Settings catalog**.
375
+
3. Select **Windows 10 and later** > **Settings catalog**.
379
376
380
-
4. Create a name for the new profile, and search for **Windows Subsystem for Linux** to see and add the full list of available settings.
377
+
4. Create a name for the new profile, and search for **Windows Subsystem for Linux** to see and add the full list of available settings.
381
378
382
-
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
379
+
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
383
380
384
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:
0 commit comments