Skip to content

Commit 1101bed

Browse files
committed
Fixes #2
1 parent ed0c81a commit 1101bed

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

defender-endpoint/mac-support-configuration.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ ms.date: 04/30/2024
3232

3333
> 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)
3434
35-
## Configuration is not applied as expected
35+
## Configuration isn't applied as expected
3636

3737
You configured Microsoft Defender with settings that you need, and you don't see some (or all) of them applied.
3838
How to troubleshoot it?
@@ -52,30 +52,31 @@ Configuration sources in the order of priority ("1" is the highest priority):
5252
1) MDE Attach, Defender configured in Intune portal
5353
2) [MDM configuration profile](mac-jamfpro-policies.md), configured using your MDM software
5454
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
5656

5757
### MDE Attach and MDM Configuration profile
5858

5959
> [!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.
6161
6262
Use `mdatp health --field managed_by` to find out if you use MDE Attach.
6363

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.
6565
2) "MEM" indicates MDM Configuration Profile, or only local configuration
6666

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.
6868

6969
### MDE Attach and MDM configurations troubleshooting
7070

7171
Check the following files:
7272

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.
7575

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.
7777

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.
7980

8081
If you expect some settings and you see those files, then check their content:
8182

@@ -88,7 +89,7 @@ If you expect some settings and you see those files, then check their content:
8889
}
8990
```
9091

91-
Those settings must match those you configured.
92+
Those settings must match those settings that you configured.
9293
Their names, level of indirection, type must be exactly as [documented](mac-preferences.md).
9394

9495
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
112113

113114
If you don't see an expected managed preferences file, or its content is different from what you expect, then open  => System Settings => Profiles.
114115

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.
116118

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.
118120

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).
121124

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.
123126

124127
### MDE Attach Configuration - where does it come from?
125128

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

Comments
 (0)