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/linux-resources.md
+46-22Lines changed: 46 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ ms.collection:
15
15
ms.topic: troubleshooting-general
16
16
ms.subservice: linux
17
17
search.appverid: met150
18
-
ms.date: 10/11/2024
18
+
ms.date: 05/02/2025
19
19
---
20
20
21
21
# Resources
@@ -29,8 +29,13 @@ ms.date: 10/11/2024
29
29
30
30
> Want to experience Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630)
31
31
32
+
This article provides resources for resolving issues or configuring Microsoft Defender for Endpoint on Linux. This article describes how to collect diagnostic information, log installation issues, and configure Defender for Endpoint on Linux using the command line. This article also describes how to uninstall Defender for Endpoint on Linux.
33
+
32
34
## Collect diagnostic information
33
35
36
+
> [!TIP]
37
+
> Run the [Defender for Endpoint client analyzer](run-analyzer-linux.md) with live response or locally on the device to collect diagnostic information from Defender for Endpoint on Linux.
38
+
34
39
If you can reproduce a problem, first increase the logging level, run the system for some time, and then restore the logging level to the default.
35
40
36
41
1. Increase logging level:
@@ -74,17 +79,6 @@ If an error occurs during installation, the installer will only report a general
74
79
The detailed log will be saved to `/var/log/microsoft/mdatp/install.log`.
75
80
If you experience issues during installation, send us this file so we can help diagnose the cause.
76
81
77
-
## Uninstall Defender for Endpoint on Linux
78
-
79
-
There are several ways to uninstall Defender for Endpoint on Linux. If you are using a configuration tool such as Puppet, follow the package uninstallation instructions for the configuration tool.
80
-
81
-
### Manual uninstallation
82
-
83
-
-`sudo yum remove mdatp` for RHEL and variants(CentOS and Oracle Linux).
84
-
-`sudo zypper remove mdatp` for SLES and variants.
85
-
-`sudo apt-get purge mdatp` for Ubuntu and Debian systems.
86
-
-`sudo dnf remove mdatp` for Mariner
87
-
88
82
## Configure from the command line
89
83
90
84
Important tasks, such as controlling product settings and triggering on-demand scans, can be done from the command line.
@@ -97,18 +91,14 @@ By default, the command-line tool outputs the result in human-readable format. I
97
91
98
92
The following table lists commands for some of the most common scenarios. Run `mdatp help` from the Terminal to view the full list of supported commands.
|Configuration|Add/remove an antivirus exclusion for a file extension|`mdatp exclusion extension [add\|remove] --name [extension]`|
113
103
|Configuration|Add/remove an antivirus exclusion for a file|`mdatp exclusion file [add\|remove] --path [path-to-file]`|
114
104
|Configuration|Add/remove an antivirus exclusion for a directory|`mdatp exclusion folder [add\|remove] --path [path-to-directory]`|
@@ -143,12 +133,46 @@ The following table lists commands for some of the most common scenarios. Run `m
143
133
|Quarantine management|Remove all files from the quarantine|`mdatp threat quarantine remove-all`|
144
134
|Quarantine management|Add a file detected as a threat to the quarantine|`mdatp threat quarantine add --id [threat-id]`|
145
135
|Quarantine management|Remove a file detected as a threat from the quarantine|`mdatp threat quarantine remove --id [threat-id]`|
146
-
|Quarantine management|Restore a file from the quarantine. Available in Defender for Endpoint version lower than 101.23092.0012.|`mdatp threat quarantine restore --id [threat-id] --path [destination-folder]`|
147
-
|Quarantine management|Restore a file from the quarantine with Threat ID. Available in Defender for Endpoint version 101.23092.0012 or higher.|`mdatp threat quarantine restore threat-id --id [threat-id] --destination-path [destination-folder]`|
148
-
|Quarantine management|Restore a file from the quarantine with Threat Original Path. Available in Defender for Endpoint version 101.23092.0012 or higher.|`mdatp threat quarantine restore threat-path --path [threat-original-path] --destination-path [destination-folder]`|
136
+
|Quarantine management|Restore a file from the quarantine. Available in Defender for Endpoint version earlier than `101.23092.0012`.|`mdatp threat quarantine restore --id [threat-id] --path [destination-folder]`|
137
+
|Quarantine management|Restore a file from the quarantine with Threat ID. Available in Defender for Endpoint version `101.23092.0012` or later.|`mdatp threat quarantine restore threat-id --id [threat-id] --destination-path [destination-folder]`|
138
+
|Quarantine management|Restore a file from the quarantine with Threat Original Path. Available in Defender for Endpoint version `101.23092.0012` or later.|`mdatp threat quarantine restore threat-path --path [threat-original-path] --destination-path [destination-folder]`|
149
139
|Endpoint Detection and Response|Set early preview |`mdatp edr early-preview [enabled\|disabled]`|
150
140
|Endpoint Detection and Response|Set group-id|`mdatp edr group-ids --group-id [group-id]`|
151
141
|Endpoint Detection and Response|Set / remove tag, only `GROUP` supported|`mdatp edr tag set --name GROUP --value [tag]`|
152
142
|Endpoint Detection and Response|List exclusions (root)|`mdatp edr exclusion list [processes|paths|extensions|all]`|
153
-
|
143
+
144
+
## Uninstall Defender for Endpoint on Linux
145
+
146
+
There are several ways to uninstall Defender for Endpoint on Linux. If you are using a configuration tool such as Puppet, follow the package uninstallation instructions for the configuration tool.
147
+
148
+
### Offboard Linux devices
149
+
150
+
To prevent decommissioned devices from showing up in your device inventory, and to help ensure a more accurate Secure Score rating, add device tags to devices that you want to offboard from Defender for Endpoint. Otherwise, you'll see those devices in the [Device inventory](machines-view-overview.md) for 180 days.
151
+
152
+
1. Create a [device tag](/defender-endpoint/machine-tags), and name the tag `decommissioned`. Assign the tag to the Linux devices that you want to offboard from Defender for Endpoint.
153
+
154
+
2. Create a [Device group](/defender-endpoint/machine-groups) and name it something like, `Decommissioned Linux`. Assign this tag to an appropriate user group.
155
+
156
+
3. In the [Microsoft Defender portal](https://security.microsoft.com), in the navigation pane, select **Settings** > **Offboard**. In the **Select operating system to start offboarding process**, select **Linux Server**, and then select a deployment method.
157
+
158
+
:::image type="content" source="media/offboard-linux.png" alt-text="Screenshot showing Offboarding page in the Microsoft Defender portal.":::
159
+
160
+
Or, if you're using a non-Microsoft device management solution, disable integration with Defender for Endpoint.
161
+
162
+
4. Uninstall Defender for Endpoint on the devices.
163
+
164
+
### Manual uninstallation
165
+
166
+
-`sudo yum remove mdatp` for RHEL and variants(CentOS and Oracle Linux).
167
+
-`sudo zypper remove mdatp` for SLES and variants.
168
+
-`sudo apt-get purge mdatp` for Ubuntu and Debian systems.
169
+
-`sudo dnf remove mdatp` for Mariner.
170
+
171
+
## Related content
172
+
173
+
-[Microsoft Defender for Endpoint on Linux](microsoft-defender-endpoint-linux.md)
174
+
-[Prerequisites for Microsoft Defender for Endpoint on Linux](mde-linux-prerequisites.md)
175
+
-[Configure security settings in Microsoft Defender for Endpoint on Linux](linux-preferences.md)
176
+
-[Run the client analyzer on Linux](run-analyzer-linux.md)
177
+
154
178
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
0 commit comments