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/mac-resources.md
+32-22Lines changed: 32 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ ms.collection:
14
14
ms.topic: conceptual
15
15
ms.subservice: macos
16
16
search.appverid: met150
17
-
ms.date: 04/30/2024
17
+
ms.date: 05/07/2024
18
18
---
19
19
20
20
# Resources for Microsoft Defender for Endpoint on macOS
@@ -31,7 +31,7 @@ ms.date: 04/30/2024
31
31
32
32
## Collecting diagnostic information
33
33
34
-
If you can reproduce a problem, increase the logging level, run the system for some time, and restore the logging level to the default.
34
+
If you can reproduce a problem, increase the logging level, run the system for some time, and then restore the logging level to the default.
35
35
36
36
1. Increase logging level:
37
37
@@ -43,9 +43,9 @@ If you can reproduce a problem, increase the logging level, run the system for s
43
43
Log level configured successfully
44
44
```
45
45
46
-
2. Reproduce the problem
46
+
2. Reproduce the problem.
47
47
48
-
3. Run `sudo mdatp diagnostic create` to back up the Microsoft Defender for Endpoint logs. The files will be stored inside a .zip archive. This command will also print out the file path to the backup after the operation succeeds.
48
+
3. Run `sudo mdatp diagnostic create` to back up the Microsoft Defender for Endpoint logs. The files are stored inside a `.zip` archive. This command also prints the file path to the backup after the operation succeeds.
49
49
50
50
> [!TIP]
51
51
> By default, diagnostic logs are saved to `/Library/Application Support/Microsoft/Defender/wdavdiag/`. To change the directory where diagnostic logs are saved, pass `--path [directory]` to the below command, replacing `[directory]` with the desired directory.
@@ -58,7 +58,7 @@ If you can reproduce a problem, increase the logging level, run the system for s
@@ -70,21 +70,20 @@ If you can reproduce a problem, increase the logging level, run the system for s
70
70
71
71
## Logging installation issues
72
72
73
-
If an error occurs during installation, the installer will only report a general failure.
73
+
If an error occurs during installation, the installer reports a general failure only. The detailed log is saved to `/Library/Logs/Microsoft/mdatp/install.log`. If you experience issues during installation, send us this file when you open your support case so we can help diagnose the cause.
74
74
75
-
The detailed log will be saved to `/Library/Logs/Microsoft/mdatp/install.log`. If you experience issues during installation, send us this file so we can help diagnose the cause.
76
-
For further troubleshooting installation issues, please review [Troubleshoot installation issues for Microsoft Defender for Endpoint on macOS](mac-support-install.md)
75
+
For further troubleshooting installation issues, see [Troubleshoot installation issues for Microsoft Defender for Endpoint on macOS](mac-support-install.md).
77
76
78
77
## Uninstalling
79
78
80
79
> [!NOTE]
81
-
> Before uninstalling Microsoft Defender for Endpoint on macOS, please offboard per [Offboard non-Windows devices](configure-endpoints-non-windows.md).
80
+
> Before uninstalling Microsoft Defender for Endpoint on macOS, offboard each device per [Offboard non-Windows devices](configure-endpoints-non-windows.md).
82
81
83
-
There are several ways to uninstall Microsoft Defender for Endpoint on macOS. Note that while centrally managed uninstall is available on JAMF, it is not yet available for Microsoft Intune.
82
+
There are several ways to uninstall Microsoft Defender for Endpoint on macOS. Although centrally managed uninstallation is available on JAMF, it's not yet available for Microsoft Intune.
84
83
85
84
### Interactive uninstallation
86
85
87
-
- Open **Finder > Applications**. Right click on **Microsoft Defender for Endpoint > Move to Trash**.
86
+
- Open **Finder > Applications**. Right click on **Microsoft Defender for Endpoint**, and then select **Move to Trash**.
88
87
89
88
### Supported output types
90
89
@@ -100,19 +99,27 @@ Supports table and JSON format output types. For each command, there's a default
100
99
101
100
### Using JAMF Pro
102
101
103
-
To uninstall Microsoft Defender for Endpoint on macOS using JAMF Pro upload the **offboarding profile**.
102
+
To uninstall Microsoft Defender for Endpoint on macOS using JAMF Pro upload the offboarding profile.
104
103
105
-
The **offboarding profile** should be uploaded without any modifications, and with Preference Domain name set to **com.microsoft.wdav.atp.offboarding**:
104
+
The offboarding profile should be uploaded without any modifications, and with Preference Domain name set to `com.microsoft.wdav.atp.offboarding`, as shown in the following image:
106
105
107
106
:::image type="content" source="/defender/media/defender-endpoint/jamf-pro-offboarding.png" alt-text="Screenshot of the JAMF offboarding screen" lightbox="/defender/media/defender-endpoint/jamf-pro-offboarding.png":::
108
107
108
+
109
+
> [!NOTE]
110
+
> If you have trouble uninstalling Defender for Endpoint on Mac, and you see in your reports an item for *Microsoft Defender Endpoint Security Extension*, follow these steps:
111
+
> 1. Reinstall the Microsoft Defender app.
112
+
> 2. Drag **Microsoft Defender.app** to **Trash**.
113
+
> 3. Run this command: `sudo /Library/Application Support/Microsoft/Defender/uninstall/install_helper execute --path '/Library/Application Support/Microsoft/Defender/uninstall/uninstall' --args --post-uninstall-hook`.
114
+
> 4. Restart the device.
115
+
109
116
## Configuring from the command line
110
117
111
-
Important tasks, such as controlling product settings and triggering on-demand scans, can be done from the command line:
118
+
Important tasks, such as controlling product settings and triggering on-demand scans, can be done by using the command line:
@@ -141,11 +148,11 @@ Important tasks, such as controlling product settings and triggering on-demand s
141
148
|Quarantine management|Remove all files from the quarantine|`mdatp threat quarantine remove-all`|
142
149
|Quarantine management|Add a file detected as a threat to the quarantine|`mdatp threat quarantine add --id [threat-id]`|
143
150
|Quarantine management|Remove a file detected as a threat from the quarantine|`mdatp threat quarantine remove --id [threat-id]`|
144
-
|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]`|
145
-
|Quarantine management|Restore a file from the quarantine with Threat ID. Available in Defender for Endpoint version 101.23092.0012 or higher.|`mdatp threat restore threat-id --id [threat-id] --destination-path [destination-folder]`|
146
-
|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 restore threat-path --path [threat-original-path] --destination-path [destination-folder]`|
151
+
|Quarantine management|Restore a file from the quarantine. Available in Defender for Endpoint version before [101.23092.0012](mac-whatsnew.md#nov-2023-build-101230920007--release-version-2012309270).|`mdatp threat quarantine restore --id [threat-id] --path [destination-folder]`|
152
+
|Quarantine management|Restore a file from the quarantine with Threat ID. Available in Defender for Endpoint version [101.23092.0012](mac-whatsnew.md#nov-2023-build-101230920007--release-version-2012309270) or later.|`mdatp threat restore threat-id --id [threat-id] --destination-path [destination-folder]`|
153
+
|Quarantine management|Restore a file from the quarantine with Threat Original Path. Available in Defender for Endpoint version [101.23092.0012](mac-whatsnew.md#nov-2023-build-101230920007--release-version-2012309270) or later.|`mdatp threat restore threat-path --path [threat-original-path] --destination-path [destination-folder]`|
|Health|Check the product's health|`mdatp health`|
156
163
|Health|Check for a specific product attribute|`mdatp health --field [attribute: healthy/licensed/engine_version...]`|
157
-
|EDR|EDR list exclusions (root)|`mdatp edr exclusion list [processes|paths|extensions|all]`|
164
+
|EDR|EDR list exclusions (root)|`mdatp edr exclusion list [processes|paths|extensions|all]`|
158
165
|EDR|Set/Remove tag, only GROUP supported|`mdatp edr tag set --name GROUP --value [name]`|
159
166
|EDR|Remove group tag from device|`mdatp edr tag remove --tag-name [name]`|
160
167
|EDR|Add Group ID|`mdatp edr group-ids --group-id [group]`|
@@ -175,7 +182,7 @@ To enable autocompletion in zsh:
175
182
cat ~/.zshrc | grep autoload
176
183
```
177
184
178
-
- If the preceding command does not produce any output, you can enable autocompletion using the following command:
185
+
- If the preceding command doesn't produce any output, you can enable autocompletion using the following command:
179
186
180
187
```zsh
181
188
echo"autoload -Uz compinit && compinit">>~/.zshrc
@@ -191,9 +198,12 @@ To enable autocompletion in zsh:
191
198
192
199
## Client Microsoft Defender for Endpoint quarantine directory
193
200
194
-
`/Library/Application Support/Microsoft/Defender/quarantine/` contains the files quarantined by `mdatp`. The files are named after the threat trackingId. The current trackingIds is shown with `mdatp threat list`.
201
+
`/Library/Application Support/Microsoft/Defender/quarantine/` contains the files quarantined by `mdatp`. The files are named after the threat trackingId. The current trackingIds are shown with `mdatp threat list`.
195
202
196
203
## Microsoft Defender for Endpoint portal information
204
+
197
205
The Microsoft Defender for Endpoint blog,
198
206
[EDR capabilities for macOS have now arrived](https://techcommunity.microsoft.com/t5/microsoft-defender-atp/edr-capabilities-for-macos-have-now-arrived/ba-p/1047801) provides detailed guidance on what to expect.
207
+
208
+
199
209
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
0 commit comments