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-28Lines changed: 25 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,20 +1,19 @@
1
1
---
2
2
title: Microsoft Defender for Endpoint plug-in for Windows Subsystem for Linux (WSL)
3
-
description: Learn how to set up and use the MDE plugin for Windows Subsystem for Linux
3
+
description: Learn how to set up and use the MDE plugin for Windows Subsystem for Linux.
4
4
author: siosulli
5
5
ms.author: siosulli
6
6
manager: deniseb
7
-
ms.reviewer: pahuijbr
7
+
ms.reviewer: pahuijbr; gokulgiju
8
8
ms.service: defender-endpoint
9
9
ms.topic: how-to
10
10
ms.localizationpriority: medium
11
11
ms.collection:
12
12
- m365-security
13
13
- tier2
14
14
audience: ITPro
15
-
ms.date: 04/09/2024
15
+
ms.date: 04/25/2024
16
16
search.appverid: MET150
17
-
18
17
---
19
18
20
19
# Microsoft Defender for Endpoint plug-in for Windows Subsystem for Linux (WSL)
@@ -27,13 +26,13 @@ The Windows Subsystem for Linux (WSL) 2, which replaces the previous version of
27
26
28
27
Be aware of the following before you start:
29
28
30
-
1.The plug-in doesn't yet automatically update. When a new plug-in version is released, the new MSI package needs to be applied to perform the update. You can apply the new package by using any tool that deploys software. Updates are coming soon through Microsoft Update. If preferred, you can continue to use the MSI package method.
29
+
1. The plug-in doesn't yet automatically update. When a new plug-in version is released, the new MSI package needs to be applied to perform the update. You can apply the new package by using any tool that deploys software. Updates are coming soon through Microsoft Update. If preferred, you can continue to use the MSI package method.
31
30
32
-
2.As 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 a (any) distribution has been running long enough (at least 30 minutes), it does show up.
31
+
2. As 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 a (any) distribution has been running long enough (at least 30 minutes), it does show up.
33
32
34
-
3.If you're using a proxy in your (test) environment, make sure that the plug-in is set up to use it correctly. WSL is typically not automatically configured to use a proxy. For more information, see the section, [Setting a proxy for Defender running in WSL](#setting-a-proxy-for-defender-running-in-wsl).
33
+
3. If you're using a proxy in your (test) environment, make sure that the plug-in is set up to use it correctly. WSL is typically not automatically configured to use a proxy. For more information, see the section, [Setting a proxy for Defender running in WSL](#setting-a-proxy-for-defender-running-in-wsl).
35
34
36
-
4.The use of a custom kernel in combination with the plug-in is not supported. When you attempt to launch WSL with the plugin installed, you will encounter the error *A fatal error was returned by plugin 'DefenderforEndpointPlug-in'. Error message: 'Custom Kernel/Configuration not supported.'*.
35
+
4. The use of a custom kernel in combination with the plug-in isn't supported. When you attempt to launch WSL with the plugin installed, you'll encounter the error *A fatal error was returned by plugin 'DefenderforEndpointPlug-in'. Error message: 'Custom Kernel/Configuration not supported.'*.
37
36
38
37
## Software prerequisites
39
38
@@ -63,7 +62,7 @@ Components installed:
63
62
64
63
## Installation steps
65
64
66
-
If you Windows Subsystem for Linux isn't installed yet, follow these steps:
65
+
If your Windows Subsystem for Linux isn't installed yet, follow these steps:
67
66
68
67
1. Open Terminal or Command Prompt. (In Windows, go to **Start** > **Command Prompt**. Or, right-click the start button and then select **Terminal**.)
69
68
@@ -98,7 +97,7 @@ After WSL is running and fully up to date, follow these steps to install the plu
98
97
99
98
4. Run the command `.\healthcheck.exe`.
100
99
101
-
5. Review the details of Defender and WSL and make sure they match or exceed the following:
100
+
5. Review the details of Defender and WSL and make sure they match or exceed the following requirements:
102
101
103
102
-**Defender Plug-in Version**: `0.23.1102.4`
104
103
-**WSL Version**: `2.0.7.0` or later
@@ -117,15 +116,15 @@ If you want to use the host network and network proxy setting for MDE for WSL pl
117
116
118
117
## Plug-in Proxy selection
119
118
120
-
If your host machine contains multiple proxy settings, the plug-in will select the proxy configurations with the following hierarchy
119
+
If your host machine contains multiple proxy settings, the plug-in selects the proxy configurations with the following hierarchy:
121
120
122
-
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`)
121
+
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`).
123
122
124
-
2. Winhttp proxy (configured through netsh command)
123
+
2.`Winhttp` proxy (configured through `netsh` command).
125
124
126
-
3. Network & Internet proxy settings
125
+
3. Network & Internet proxy settings.
127
126
128
-
Example: If your host machine as both Winhttp proxy as well as Network & Internet proxy, plug-in will select `Winhttp proxy` as the proxy configuration for plug-in.
127
+
Example: If your host machine has both *Winhttp proxy* and *Network & Internet proxy*, the plug-in selects `Winhttp proxy` as the proxy configuration.
129
128
130
129
## Connectivity test for Defender running in WSL
131
130
@@ -135,20 +134,20 @@ The following procedure describes how to confirm that Defender in Endpoint in WS
135
134
136
135
2. Create a registry key with the following details:
137
136
138
-
-**Name:**`ConnectivityTest`
139
-
-**Type:**`REG_DWORD`
140
-
-**Value:**`Number of seconds plug-in must wait before running test. (Recommended: 60 seconds)`
3. Once the registry is set, restart wsl using the following steps:
144
143
145
-
1. Open Command Prompt and run `wsl --shutdown`.
144
+
1. Open Command Prompt and run the command, `wsl --shutdown`.
146
145
147
146
2. Run the command `wsl`.
148
147
149
148
4. Wait for 5 minutes and then run `healthcheck.exe` (located at `C:\Program Files\Microsoft Defender for Endpoint plug-in for WSL\tools` for the results of the connectivity test).
150
149
151
-
If successful, the connectivity test shows success.
150
+
If successful, you can see that the connectivity test was successful.
152
151
153
152
> [!NOTE]
154
153
> To set a proxy for use in WSL containers (the distributions running on the subsystem), see [Advanced settings configuration in WSL](/windows/wsl/wsl-config).
@@ -270,19 +269,17 @@ DeviceProcessEvents
270
269
271
270
:::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":::
272
271
273
-
6. Microsoft Defender Endpoint for WSL supports Linux distributions running on WSL 2. If they are associated with WSL 1, you may face issues. Therefore, it is advised to disable WSL 1. To do so with the Intune policy, perform the following steps :
272
+
6. 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 is advised to disable WSL 1. To do so with the Intune policy, perform the following steps :
274
273
275
274
1. Navigate to your Microsoft Intune admin center portal.
276
275
277
-
2. Go to Devices -> Configuration Profiles -> Create -> New Policy.
276
+
2. Go to **Devices** > **Configuration Profiles** > **Create** > **New Policy**.
278
277
279
-
3. Select Windows 10 and later -> Settings catalog.
278
+
3. Select **Windows 10 and later** > **Settings catalog**.
280
279
281
-
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.
280
+
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.
282
281
283
-
5. Set the Allow WSL1 setting to Disabled.
284
-
285
-
This will ensure only WSL 2 distributions can be used.
282
+
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
286
283
287
284
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