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-support-configuration.md
+19-16Lines changed: 19 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,7 @@ ms.date: 04/30/2024
32
32
33
33
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
34
34
35
-
## Configuration is not applied as expected
35
+
## Configuration isn't applied as expected
36
36
37
37
You configured Microsoft Defender with settings that you need, and you don't see some (or all) of them applied.
38
38
How to troubleshoot it?
@@ -52,30 +52,31 @@ Configuration sources in the order of priority ("1" is the highest priority):
52
52
1) MDE Attach, Defender configured in Intune portal
53
53
2)[MDM configuration profile](mac-jamfpro-policies.md), configured using your MDM software
54
54
3)[Local configuration](mac-resources.md#supported-output-types), that you made using `mdatp config ...` command as local administrator, or through Microsoft Defender's application
55
-
4) Default setting, that is used when you provided no explicit setting
55
+
4) Default setting that is used when you provided no explicit setting
56
56
57
57
### MDE Attach and MDM Configuration profile
58
58
59
59
> [!CAUTION]
60
-
> MDE Attach and MDM Configuration Profile are mutually excluded. If you provided*some* configuration for both, then only MDE Attach settings will be used, and *all* MDM settings will be ignored! Do not use them together.
60
+
> MDE Attach and MDM Configuration Profile are mutually excluded. If you provide*some* configuration for both, then only MDE Attach settings are used, and *all* MDM settings are ignored! Don't use them together.
61
61
62
62
Use `mdatp health --field managed_by` to find out if you use MDE Attach.
63
63
64
-
1) "MDE" indicates MDE Attach. Any configuration specified with a MDM configuration profile is ignored.
64
+
1) "MDE" indicates MDE Attach. Any configuration specified with an MDM configuration profile is ignored.
65
65
2) "MEM" indicates MDM Configuration Profile, or only local configuration
66
66
67
-
You can run `mdatp health` to get the configuration that Microsoft Defender is currently used. If you see "[managed]" next to a value, then it is currently configured through an MDM Configuration Profile. If there is no "[managed]", then it is configured locally or via MDE Attach.
67
+
You can run `mdatp health` to get the configuration that Microsoft Defender is currently used. If you see "[managed]" next to a value, then it's currently configured through an MDM Configuration Profile. If there's no "[managed]", then it's configured locally or via MDE Attach.
68
68
69
69
### MDE Attach and MDM configurations troubleshooting
70
70
71
71
Check the following files:
72
72
73
-
1)`/Library/Preferences/com.microsoft.mdeattach.plist` - Microsoft Defender reads this file for settings delivered by MDE Attach. If you expect some setting and you don't see it configured - check that it's there
74
-
2)`/Library/Managed Preferences/com.microsoft.wdav.plist` and `/Library/Managed Preferences/com.microsoft.wdav.ext.plist` - Microsoft Defender reads these files for settings delivered by MDM.
73
+
1)`/Library/Preferences/com.microsoft.mdeattach.plist` - Microsoft Defender reads this file for settings delivered by MDE Attach. If you expect some setting and you don't see it configured, then check that it's there
74
+
2)`/Library/Managed Preferences/com.microsoft.wdav.plist` and `/Library/Managed Preferences/com.microsoft.wdav.ext.plist` - Microsoft Defender reads these files for settings delivered by MDM.
75
75
76
-
Note that the file paths and names must be exactly like above! If you see a similar but a bit different file path - Microsoft Defender will ignore it.
76
+
The file paths and names must be exactly like described! If you see a similar but a bit different file path, then it means that Microsoft Defender ignores it.
77
77
78
-
If you expect some MDM settings and do not see those MDM files above, it means that MDM configuration profiles were not delivered to your machine at all. Consult your MDM software (JAMF, Intune, etc.) resources to troubleshoot profiles delivery.
78
+
If you expect some MDM settings and don't see those files, it means that MDM has not delivered configuration profiles to your machine at all.
79
+
To troubleshoot profiles delivery, consult your MDM software (JAMF, Intune, etc.) resources.
79
80
80
81
If you expect some settings and you see those files, then check their content:
81
82
@@ -88,7 +89,7 @@ If you expect some settings and you see those files, then check their content:
88
89
}
89
90
```
90
91
91
-
Those settings must match those you configured.
92
+
Those settings must match those settings that you configured.
92
93
Their names, level of indirection, type must be exactly as [documented](mac-preferences.md).
93
94
94
95
For example, if `plist` tells you that "antivirusEngine" is inside a different group, then you can be confident that Microsoft Defender *ignores* "enforcementLevel" setting altogether:
@@ -112,15 +113,17 @@ macOS updates /Library/Managed Preferences/ files based on Profiles deployed ove
112
113
113
114
If you don't see an expected managed preferences file, or its content is different from what you expect, then open => System Settings => Profiles.
114
115
115
-
You can see all profiles deployed over MDM under "Device (Managed)". Find a profile that you configured in MDM for Microsoft Defender configuration. You can open it and inspect its content, it must match what is in /Library/Managed Preferences/com.microsoft.wdav.plist and what you configured in MDM.
116
+
You can see all profiles deployed over MDM under "Device (Managed)." Find a profile that you configured in MDM for Microsoft Defender configuration.
117
+
You can open it and inspect its content. It must match what is in /Library/Managed Preferences/com.microsoft.wdav.plist and what you configured in MDM.
116
118
117
-
If you don't see any managed profile for com.microsoft.wdav, then MDM did not deliver it. Consult your MDM software documentation for troubleshooting, there can be multiple reasons why it happened, troubleshooting of MDM is out of scope for Microsoft Defender documentation.
119
+
If you don't see any managed profile for com.microsoft.wdav, then MDM didn't deliver it. Consult your MDM software documentation for troubleshooting, there can be multiple reasons why it happened, troubleshooting of MDM is out of scope for Microsoft Defender documentation.
118
120
119
-
If you see *more than one* configuration profile for the same com.microsoft.wdav, then it can be the reason of not quite expected configuration of Microsoft Defender.
120
-
macOS performs some merging of those profiles into a single .plist, but it can properly merge only the top level of configuration. I.e. you cannot spread different "antivirusEngine" settings across two com.microsoft.wdav configuration profiles, MDM will use only one of them randomly, and ignore the rest. You can use additional com.microsoft.wdav.ext profile if you need to put settings to two profiles (again, there must be at most one configuration profile with com.microsoft.wdav.ext as well).
121
+
If you see *more than one* configuration profile for the same com.microsoft.wdav, then it can be the reason of not expected configuration of Microsoft Defender.
122
+
macOS performs some merging of those profiles into a single .plist, but it can properly merge only the top level of configuration.
123
+
I.e., you can't spread different "antivirusEngine" settings across two com.microsoft.wdav configuration profiles, MDM uses only one of them randomly, and ignore the rest. You can use extra com.microsoft.wdav.ext profile if you need to put settings to two profiles (again, there must be at most one configuration profile with com.microsoft.wdav.ext as well).
121
124
122
-
In other words, avoid having more than one configuration profile for the same id.
125
+
In other words, avoid having more than one configuration profile for the same identifier.
123
126
124
127
### MDE Attach Configuration - where does it come from?
125
128
126
-
It is not delivered over MDM. Consult MDE Attach documentation for how to troubleshoot it.
129
+
It isn't delivered over MDM. Consult MDE Attach documentation for how to troubleshoot it.
0 commit comments