Skip to content

Commit 47f60db

Browse files
authored
Merge pull request #1340 from YongRhee-MSFT/docs-editor/mac-resources-1726186394
Update mac-resources.md
2 parents eee75ba + 97f1388 commit 47f60db

File tree

1 file changed

+52
-36
lines changed

1 file changed

+52
-36
lines changed

defender-endpoint/mac-resources.md

Lines changed: 52 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.collection:
1414
ms.topic: conceptual
1515
ms.subservice: macos
1616
search.appverid: met150
17-
ms.date: 05/17/2024
17+
ms.date: 09/13/2024
1818
---
1919

2020
# Resources for Microsoft Defender for Endpoint on macOS
@@ -74,16 +74,7 @@ If an error occurs during installation, the installer reports a general failure
7474

7575
For further troubleshooting installation issues, see [Troubleshoot installation issues for Microsoft Defender for Endpoint on macOS](mac-support-install.md).
7676

77-
## Uninstalling
78-
79-
> [!NOTE]
80-
> Before uninstalling Microsoft Defender for Endpoint on macOS, offboard each device per [Offboard non-Windows devices](configure-endpoints-non-windows.md).
81-
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.
83-
84-
### Interactive uninstallation
85-
86-
- Open **Finder > Applications**. Right click on **Microsoft Defender for Endpoint**, and then select **Move to Trash**.
77+
## Configuring from the command line
8778

8879
### Supported output types
8980

@@ -93,28 +84,6 @@ Supports table and JSON format output types. For each command, there's a default
9384

9485
`-output table`
9586

96-
### From the command line
97-
98-
- `sudo '/Library/Application Support/Microsoft/Defender/uninstall/uninstall'`
99-
100-
### Using JAMF Pro
101-
102-
To uninstall Microsoft Defender for Endpoint on macOS using JAMF Pro upload the offboarding profile.
103-
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:
105-
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":::
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-
116-
## Configuring from the command line
117-
11887
Important tasks, such as controlling product settings and triggering on-demand scans, can be done by using the command line:
11988

12089
|Group|Scenario|Command|
@@ -201,10 +170,57 @@ To enable autocompletion in zsh:
201170

202171
`/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`.
203172

204-
## Microsoft Defender for Endpoint portal information
173+
## Uninstalling
174+
175+
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.
176+
177+
All of the uninstall of Microsoft Defender for Endpoint on macOS require the following:
178+
179+
1. Create a [device tag](/defender-endpoint/machine-tags), and name the tag *decommissioned* and assign it to the macOS where Microsoft Defender for macOS is being uninstalled.
180+
181+
1. Create a [Device group](/defender-endpoint/machine-groups) and name it (e.g. *Decommissioned macOS*) and assign a user *group* that should be able to see them.
182+
183+
Note: Steps 1 and 2 are optional if you do not want to see these devices that are retired in the "Device inventory" for 180 days.
184+
185+
1. Remove the "Set Preferences" policies that contain [Tamper Protection](/defender-endpoint/tamperprotection-macos) or through the manual configuration.
186+
187+
1. Offboard each device per [Offboard non-Windows devices](configure-endpoints-non-windows.md).
188+
189+
1. Uninstall the Microsoft Defender for Endpoint for macOS apps
190+
191+
1. Remove the device from the *group* for *system extension* policies if an MDM was used to set them.
192+
193+
### Interactive uninstallation
194+
195+
- Open **Finder > Applications**. Right click on **Microsoft Defender for Endpoint**, and then select **Move to Trash**.
196+
197+
### From the command line
198+
199+
- `sudo '/Library/Application Support/Microsoft/Defender/uninstall/uninstall'`
200+
201+
### Using JAMF Pro
202+
203+
To uninstall Microsoft Defender for Endpoint on macOS using JAMF Pro upload the offboarding profile.
204+
205+
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:
206+
207+
:::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":::
208+
209+
210+
> [!NOTE]
211+
> 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:
212+
> 1. Reinstall the Microsoft Defender app.
213+
> 2. Drag **Microsoft Defender.app** to **Trash**.
214+
> 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`.
215+
> 4. Restart the device.
216+
217+
## The Microsoft Defender portal
218+
219+
When threats are detected, your security team can view detections and if necessary, take response actions on a device. For more information, see the following resources:
205220

206-
The Microsoft Defender for Endpoint blog,
207-
[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.
221+
- [Overview of endpoint detection and response](/defender-endpoint/overview-endpoint-detection-response)
222+
- [Tech Community blog: 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)
223+
- [Microsoft Defender portal overview](/defender-xdr/microsoft-365-defender-portal)
208224

209225

210226
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]

0 commit comments

Comments
 (0)