Skip to content

Commit 5f82256

Browse files
authored
Update md
1 parent f582611 commit 5f82256

File tree

1 file changed

+27
-26
lines changed

1 file changed

+27
-26
lines changed

defender-endpoint/mde-plugin-wsl.md

Lines changed: 27 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Components installed:
6060

6161
## Installation steps
6262

63-
If you Windows Subsystem for Linux isn't installed yet, follow these steps:
63+
If your Windows Subsystem for Linux isn't installed yet, follow these steps:
6464

6565
1. Open Terminal or Command Prompt. (In Windows, go to **Start** > **Command Prompt**. Or, right-click the start button and then select **Terminal**.)
6666

@@ -85,6 +85,7 @@ If you Windows Subsystem for Linux isn't installed yet, follow these steps:
8585

8686
> [!NOTE]
8787
> If `WslService` is running, it stops during the installation process. You do not need to onboard the subsystem separately; instead, the plug-in automatically onboards to the tenant the Windows host is onboarded to.
88+
8889
## Installation validation checklist
8990

9091
1. After update or installation, wait for at least five minutes for the plug-in to fully initialize and write log output.
@@ -95,7 +96,7 @@ If you Windows Subsystem for Linux isn't installed yet, follow these steps:
9596

9697
4. Run the command `.\healthcheck.exe`.
9798

98-
5. Review the details of Defender and WSL and make sure they match or exceed the following:
99+
5. Review the details of Defender and WSL and make sure they match or exceed the following requirements:
99100

100101
- **Defender Plug-in Version**: `0.23.1102.4`
101102
- **WSL Version**: `2.0.7.0` or later
@@ -114,15 +115,15 @@ If you want to use the host [network and network proxy setting](https://support.
114115

115116
## Plug-in Proxy selection
116117

117-
If your host machine contains multiple proxy settings, the plug-in will select the proxy configurations with the following hierarchy
118+
If your host machine contains multiple proxy settings, the plug-in selects the proxy configurations with the following hierarchy:
118119

119-
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`)
120+
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`).
120121

121-
2. Winhttp proxy (configured through netsh command)
122+
2. `Winhttp` proxy (configured through `netsh` command).
122123

123-
3. Network & Internet proxy settings
124+
3. Network & Internet proxy settings.
124125

125-
**Example:** If your host machine has both Winhttp proxy as well as Network & Internet proxy, plug-in will select `Winhttp proxy` as the proxy configuration for plug-in.
126+
Example: If your host machine has both *Winhttp proxy* and *Network & Internet proxy*, the plug-in selects `Winhttp proxy` as the proxy configuration.
126127

127128
> [!NOTE]
128129
> The `DefenderProxyServer` registry key is no longer supported. Follow the above mentioned steps to configure proxy in plug-in.
@@ -135,23 +136,24 @@ The following procedure describes how to confirm that Defender in Endpoint in WS
135136

136137
2. Create a registry key with the following details:
137138

138-
- **Name:** `ConnectivityTest`
139-
- **Type:** `REG_DWORD`
140-
- **Value:** `Number of seconds plug-in must wait before running test. (Recommended: 60 seconds)`
141-
- **Path:** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\Plugins\DefenderPlug-in`
139+
- **Name**: `ConnectivityTest`
140+
- **Type**: `REG_DWORD`
141+
- **Value**: `Number of seconds plug-in must wait before running test. (Recommended: 60 seconds)`
142+
- **Path**: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss\Plugins\DefenderPlug-in`
142143

143144
3. Once the registry is set, restart wsl using the following steps:
144145

145-
1. Open Command Prompt and run `wsl --shutdown`.
146+
1. Open Command Prompt and run the command, `wsl --shutdown`.
146147

147148
2. Run the command `wsl`.
148149

149150
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).
150151

151-
If successful, the connectivity test shows success.
152+
If successful, you can see that the connectivity test was successful.
152153

153154
> [!NOTE]
154155
> 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).
156+
155157
## Verifying functionality and SOC analyst experience
156158

157159
After installing the plug-in, the subsystem and all its running containers are onboarded to the [Microsoft Defender portal](https://security.microsoft.com).
@@ -186,6 +188,7 @@ To test the plug-in after installation, follow these steps:
186188

187189
> [!NOTE]
188190
> It takes about 5 minutes for the events to appear on the Microsoft Defender portal
191+
189192
Treat the machine as if it were a regular Linux host in your environment to perform testing against. In particular, we would like to get your feedback on the ability to surface potentially malicious behavior using the new plug-in.
190193

191194
### Advanced hunting
@@ -245,9 +248,9 @@ DeviceProcessEvents
245248
4. If you don't see any devices in the Microsoft Defender portal, or you don't see any events in the timeline, check these things:
246249

247250
- If you aren't seeing a machine object, make sure sufficient time has passed for onboarding to complete (typically up to 10 minutes).
248-
251+
249252
- Make sure to use the right filters, and that you have the appropriate permissions assigned to view all device objects. (For example, is your account/group is restricted to a specific group?)
250-
253+
251254
- Use the health check tool to provide an overview of overall plug-in health. Open Terminal, and run the `healthcheck.exe` tool from `C:\Program Files\Microsoft Defender for Endpoint plug-in for WSL\tools`.
252255

253256
:::image type="content" source="media/mdeplugin-wsl/wsl-health-check-support.png" alt-text="Screenshot showing status in PowerShell." lightbox="media/mdeplugin-wsl/wsl-health-check-support.png":::
@@ -268,28 +271,26 @@ DeviceProcessEvents
268271

269272
:::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":::
270273

271-
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 :
274+
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 :
272275

273276
1. Navigate to your Microsoft Intune admin center portal.
274277

275-
2. Go to Devices -> Configuration Profiles -> Create -> New Policy.
276-
277-
3. Select Windows 10 and later -> Settings catalog.
278-
279-
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.
278+
2. Go to **Devices** > **Configuration Profiles** > **Create** > **New Policy**.
280279

281-
5. Set the Allow WSL1 setting to Disabled.
280+
3. Select **Windows 10 and later** > **Settings catalog**.
282281

283-
This will ensure only WSL 2 distributions can be used.
282+
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.
283+
284+
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
284285

285286
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:
286-
287+
287288
```powershell
288289
wsl --set-version <YourDistroName> 2
289290
```
290291

291292
To have WSL 2 as your default WSL version for new distributions to be installed in the system, run the following command in PowerShell:
292-
293+
293294
```powershell
294295
wsl --set-default-version 2
295-
```
296+
```

0 commit comments

Comments
 (0)