Skip to content

Commit 2d65c8d

Browse files
authored
Merge pull request #5480 from dkouzmanovMSFT/docs-editor/mac-updates-1762286347
Update mac-updates.md
2 parents 74b7f47 + f407e23 commit 2d65c8d

File tree

1 file changed

+74
-29
lines changed

1 file changed

+74
-29
lines changed

defender-endpoint/mac-updates.md

Lines changed: 74 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Deploy updates for Microsoft Defender for Endpoint on macOS
33
description: Control updates for Microsoft Defender for Endpoint on macOS in enterprise environments.
44
ms.service: defender-endpoint
5-
author: batamig
6-
ms.author: bagol
5+
author: paulinbar
6+
ms.author: painbar
77
ms.reviewer: joshbregman
88
manager: bagol
99
ms.localizationpriority: medium
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: install-set-up-deploy
1616
ms.subservice: macos
1717
search.appverid: met150
18-
ms.date: 04/16/2025
18+
ms.date: 11/04/2025
1919
appliesto:
2020
- Microsoft Defender for Endpoint Plan 1
2121
- Microsoft Defender for Endpoint Plan 2
@@ -58,7 +58,7 @@ For the latest information on this setting, see [ChannelName](/deployoffice/mac/
5858
5959
The channel determines the type and frequency of updates that are offered through MAU. Devices in `Beta` can try out new features before devices in `Preview` and `Current`.
6060
61-
The `Current` channel contains the most stable version of the product.
61+
The `Current` channel contains the most stable version of the product. If this entry is not included or if the entry provided in ChannelName is invalid, MAU reverts to the default "Current" channel.
6262
6363
> [!IMPORTANT]
6464
> Prior to Microsoft AutoUpdate version 4.29, channels had different names:
@@ -70,41 +70,27 @@ The `Current` channel contains the most stable version of the product.
7070
> [!TIP]
7171
> In order to preview new features and provide early feedback, it's recommended that you configure some devices in your enterprise to `Beta` or `Preview`.
7272
73-
<br>
74-
75-
76-
77-
78-
79-
****
80-
8173
|Section|Value|
8274
|---|---|
8375
|**Domain**|`com.microsoft.autoupdate2`|
8476
|**Key**|ChannelName|
8577
|**Data type**|String|
8678
|**Possible values**|Beta <p> Preview <p> Current|
87-
|||
79+
|**Notes on channels**| Beta - Absolute latest in development. Only to be used for testing and error reporting purposes.<p> Preview - This channel provides a preview of official releases. <p> Current - This channel distributes all official releases and is the default setting.|
8880
8981
> [!WARNING]
9082
> This setting changes the channel for all applications that are updated through Microsoft AutoUpdate. To change the channel only for Microsoft Defender for Endpoint on macOS, execute the following command after replacing `[channel-name]` with the desired channel:
91-
>
83+
>
9284
> ```bash
9385
> defaults write com.microsoft.autoupdate2 Applications -dict-add "/Applications/Microsoft Defender.app" " { 'Application ID' = 'WDAV00' ; 'App Domain' = 'com.microsoft.wdav' ; LCID = 1033 ; ChannelName = '[channel-name]' ; }"
9486
> ```
87+
> Admins can also control this per app setting via the example configuration provided at the bottom of this page.
9588
9689
### Change whether the "Check for Updates" button is enabled
9790
9891
For the latest information on this setting, see [EnableCheckForUpdatesButton](/deployoffice/mac/mau-preferences#enablecheckforupdatesbutton).
9992
10093
Change whether local users are able to select the "Check for Updates" option in the Microsoft AutoUpdate user interface.
101-
<br>
102-
103-
104-
105-
106-
107-
****
10894
10995
|Section|Value|
11096
|---|---|
@@ -119,13 +105,6 @@ Change whether local users are able to select the "Check for Updates" option in
119105
For the latest information on this setting, see [DisableInsiderCheckbox](/deployoffice/mac/mau-preferences#disableinsidercheckbox).
120106
121107
Set to true to make the "Join the Office Insider Program..." checkbox unavailable / greyed out to users.
122-
<br>
123-
124-
125-
126-
127-
128-
****
129108
130109
|Section|Value|
131110
|---|---|
@@ -226,11 +205,77 @@ The following configuration profile is used to:
226205
</plist>
227206
```
228207
208+
### Intune - Defender specific channel name
209+
210+
```XML
211+
<?xml version="1.0" encoding="utf-8"?>
212+
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
213+
<plist version="1">
214+
<dict>
215+
<key>PayloadUUID</key>
216+
<string>B762FF60-6ACB-4A72-9E72-459D00C936F3</string>
217+
<key>PayloadType</key>
218+
<string>Configuration</string>
219+
<key>PayloadOrganization</key>
220+
<string>Microsoft</string>
221+
<key>PayloadIdentifier</key>
222+
<string>com.microsoft.autoupdate2</string>
223+
<key>PayloadDisplayName</key>
224+
<string>Microsoft AutoUpdate settings</string>
225+
<key>PayloadDescription</key>
226+
<string>Microsoft AutoUpdate configuration settings</string>
227+
<key>PayloadVersion</key>
228+
<integer>1</integer>
229+
<key>PayloadEnabled</key>
230+
<true/>
231+
<key>PayloadRemovalDisallowed</key>
232+
<true/>
233+
<key>PayloadScope</key>
234+
<string>System</string>
235+
<key>PayloadContent</key>
236+
<array>
237+
<dict>
238+
<key>PayloadUUID</key>
239+
<string>5A6F350A-CC2C-440B-A074-68E3F34EBAE9</string>
240+
<key>PayloadType</key>
241+
<string>com.microsoft.autoupdate2</string>
242+
<key>PayloadOrganization</key>
243+
<string>Microsoft</string>
244+
<key>PayloadIdentifier</key>
245+
<string>com.microsoft.autoupdate2</string>
246+
<key>PayloadDisplayName</key>
247+
<string>Microsoft AutoUpdate configuration settings</string>
248+
<key>PayloadDescription</key>
249+
<string/>
250+
<key>PayloadVersion</key>
251+
<integer>1</integer>
252+
<key>PayloadEnabled</key>
253+
<true/>
254+
<key>Applications</key>
255+
<dict>
256+
<key>/Applications/Microsoft Defender.app</key>
257+
<dict>
258+
<key>App Domain</key>
259+
<string>com.microsoft.wdav</string>
260+
<key>Application ID</key>
261+
<string>WDAV00</string>
262+
<key>ChannelName</key>
263+
<string>Current</string>
264+
</dict>
265+
</dict>
266+
</dict>
267+
</array>
268+
</dict>
269+
</plist>
270+
```
271+
229272
To configure MAU, you can deploy this configuration profile from the management tool that your enterprise is using:
230273
231274
- From Jamf Pro, upload this configuration profile and set the Preference Domain to *com.microsoft.autoupdate2*.
232275
- From Intune, upload this configuration profile and set the custom configuration profile name to *com.microsoft.autoupdate2*.
233-
276+
277+
- You can specify a ChannelName for Defender by adding a ChannelName key and value under the Applications key. The value of the per app ChannelName key is the same as the global setting - Beta, Preview, and Current.
278+
234279
For more information, see: [Configuring Preferences for Microsoft AutoUpdate (MAU) in Microsoft 365 Enterprise](/deployoffice/mac/mau-preferences#howtocheck)
235280
236281
## Resources

0 commit comments

Comments
 (0)