PayloadKit

Microsoft AutoUpdate

com.microsoft.autoupdate2

Microsoft AutoUpdate settings

macOS

Configuration Keys (23)

Showing 23 of 23 keys

KeyTypeDescriptionDefaultRange
string—Default: —Range: —

Acknowledged Data Collection Policy

stringThe first time Version 4.12 or later of Microsoft AutoUpdate is launched, users will see a Required Data Notice dialog which provides them with information about what data from MAU is sent to Microsoft. If you don't want your users to see this Required Data Notice dialog for Microsoft AutoUpdate, you can set the following preference. Regardless of which value you set, the dialog won't be shown to your users. If you let your users see this dialog, then when the user chooses OK, the value RequiredDataOnly is used and the dialog is not shown to the user again.Default: "RequiredDataOnly"Range: Required Data Only (RequiredDataOnly), Required And Optional Data (removed in version 4.70) (RequiredAndOptionalData)

Channel Name

stringSet the update channel that is used to check for updates. Click the documentation link for more information about which channel to use.

Depends on: ManifestServer

Default: "Production"Range: Production (pre MAU 4.29) (Production), Current (MAU 4.29+) (Current), Office Insider Slow: "External" (pre MAU 4.29) (External), Preview (MAU 4.29+) (Preview), Office Insider Fast: "InsiderFast" (pre MAU 4.29) (InsiderFast), Beta (MAU 4.29+) (Beta), Custom (Custom)

Disable Insider Checkbox

booleanSet this option to disable the "Join the Office Insider Program..." checkbox.Default: falseRange: —

Enable Check for Updates Button

booleanDisable this option to make the "Check for Updates" button in unavailable.Default: trueRange: —

Enable Extended Logging

booleanEnabled extended logging for Microsoft AutoUpdate operations. Writes logs to: /Library/Logs/Microsoft/autoupdate.logDefault: falseRange: —

How to Check for Updates

stringControl how updates are checked for and handled.Default: "AutomaticCheck"Range: No auto updates or checks: "Manual" (Manual), Automatically check for updates: "AutomaticCheck" (AutomaticCheck), Automatically check for and install updates: "AutomaticDownload" (AutomaticDownload)

Manifest Server

stringForce Microsoft AutoUpdate to pull collateral using a custom server. This is good when enterprise wants to have strict control on which version of Office applications get installed. Ensure that a trailing slash is used when specifying the value as this is mandatory. This requires "ChannelName" to be set to "Custom".Default: —Range: —

Send Telemetry Data

booleanSet to false to send minimal heartbeat data, no application usage, and no environment details. Replaced by "AcknowledgedDataCollectionPolicy" in MAU 4.12.Default: falseRange: —

Start Daemon on App Launch

booleanEnable this option to trigger the MAU Daemon when other Office applications are launched.Default: trueRange: —

Ignore UI Open After Install

booleanEnable this option to prevent MAU UI from launching after install.Default: falseRange: —

Disable Opt-In Notification

booleanWhen Set to TRUE, prevents Opt-In notification/pop-up window from showing even when HowToCheck is set to Automatic.Default: falseRange: —

Update Cache Server

stringForce Microsoft AutoUpdate to pull update binaries from a custom server. This is good when internet bandwidth is limited. Ensure that a trailing slash is used when specifying the value as this is mandatory.Default: —Range: —

Update Check Interval

integerSpecifies the number of minutes between checking for updates. Default is set to check every 13 hours.Default: 780Range: —

Update Check Frequency

integerChange how often the Microsoft AutoUpdate daemon will look for updates. The default is 720 minutes (12 hrs). By reducing this value MAU will look for updates sooner.Default: 720Range: —

Update Deadline: Days Before Forced Quit

integerForce quit applications and update X number of days after MAU first detects the update on each computer.Default: —Range: —

Update Deadline: Final Countdown Timer

integerHow many minutes is the final countdown timer once the update deadline is reached.Default: 60Range: —

Update Deadline: Start Automatic Updates

integerHow many days in advance of the deadline that Automatic Download and Install mode begins. Temporarily overrides "HowToCheck" with "AutomaticDownload" until all updates are applied.Default: 3Range: —

Updater Optimization

stringIf you have a security agent like CrowdStrike installed and updates cause beachballs; Set UpdaterOptimization preference to "CPU" to prefer file-based delta updates (instead of binary deltas). The trade-off will be larger monthly updates.Default: "Size"Range: Size, CPU

Global Deferral Days

integerGlobal number of days after a release for which updates and offers to update will be postponed.Default: —Range: 1 – 28

App Specific Deferral

dictNumber of days after a release for which updates and offers to update will be postponed, per individual app. This setting takes precedence over the global setting.Default: —Range: —

App Specific Deferral Days

dictNumber of days after a release for which updates and offers to update will be postponed, per individual app. This setting takes precedence over the global setting.Default: —Range: —
{{key}}string

Application Identifier

string—Default: —Range: XCEL2019, IMCP01, OLIC02, MSau04, WDAVCONSUMER, WDAV00, WDAVSHIM, ONDR18, ONMC2019, OPIM2019, PPT32019, MSQA01, MSRD10, MSRH01, MSFB16, TEAMS10, TEAMS21, MSWD2019
{{value}}integer

Number of Days

integer—Default: —Range: —

App Specific Deferral Versions

dictUpper limits to the update version, per individual app. Discovered updates are offered/applied to and including the specified version.Default: —Range: —
{{key}}string

Application Identifier

string—Default: —Range: XCEL2019, IMCP01, OLIC02, MSau04, WDAVCONSUMER, WDAV00, WDAVSHIM, ONDR18, ONMC2019, OPIM2019, PPT32019, MSQA01, MSRD10, MSRH01, MSFB16, TEAMS10, TEAMS21, MSWD2019
{{value}}integer

Version

integer—Default: —Range: —

Applications

dictRegister applications that Microsoft AutoUpdate should update. If this is not managed MAU might have issues finding updates for applications that a user has never opened. Language Code IDs are legacy and always "1033".Default: —Range: —
dictRegister /Library/Application Support/Microsoft/MAU2.0/Microsoft AutoUpdate.app.Default: —Range: —

Application ID

required
string—Default: "MSau04"Range: AutoUpdate <= 4.6 (MSau03), AutoUpdate => 4.7 (MSau04)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —

Microsoft Defender ATP

dictRegister /Applications/Microsoft Defender.app.Default: —Range: —

Application ID

required
string—Default: "WDAV00"Range: WDAV00
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft Edge.app.Default: —Range: —

Application ID

required
string—Default: "EDGE01"Range: EDGE01
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft Excel.app.Default: —Range: —

Application ID

required
string—Default: "XCEL2019"Range: 2016 Volume License (XCEL15), 2019 Volume License/Office 365 (XCEL2019)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft OneNote.app.Default: —Range: —

Application ID

required
string—Default: "ONMC2019"Range: 2016 Volume License (ONMC15), 2019 Volume License/Office 365 (ONMC2019)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft Outlook.app.Default: —Range: —

Application ID

required
string—Default: "OPIM2019"Range: 2016 Volume License (OPIM15), 2019 Volume License/Office 365 (OPIM2019)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft PowerPoint.app.Default: —Range: —

Application ID

required
string—Default: "PPT32019"Range: 2016 Volume License (PPT315), 2019 Volume License/Office 365 (PPT32019)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Windows App.app.Default: —Range: —

Application ID

required
string—Default: "MSRD10"Range: MSRD10
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —

Microsoft Remote Desktop

dictRegister /Applications/Microsoft Remote Desktop.app.Default: —Range: —

Application ID

required
string—Default: "MSRD10"Range: MSRD10
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft Teams.app.Default: —Range: —

Application ID

required
string—Default: "TEAMS10"Range: Teams 1.0 classic (TEAMS10), Teams 2.1 (TEAMS21)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Microsoft Word.app.Default: —Range: —

Application ID

required
string—Default: "MSWD2019"Range: 2016 Volume License (MSWD15), 2019 Volume License/Office 365 (MSWD2019)
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Company Portal.app.Default: —Range: —

Application ID

required
string—Default: "IMCP01"Range: IMCP01
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/OneDrive.app.Default: —Range: —

Application ID

required
string—Default: "ONDR18"Range: ONDR18
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —
dictRegister /Applications/Skype for Business.app.Default: —Range: —

Application ID

required
string—Default: "MSFB16"Range: MSFB16
LCIDinteger

Language Code ID

required
integer—Default: 1033Range: 1033

Update Deadline: Days Before Forced Quit

integerForce quit this application and update X number of days after MAU first detects the update on each computer. Can be used in conjunction with the higher level option of the same setting for more restrictive per-application updating.Default: —Range: —

Update Deadline: Applications Forced Update Schedule

dictConfigure a deadline for a specific update version at a specific date and time for each application.Default: —Range: —
dictSchedule an update for Microsoft AutoUpdate.Default: —Range: —

Application ID

required
string—Default: "MSau04"Range: AutoUpdate <= 4.6 (MSau03), AutoUpdate => 4.7 (MSau04)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Defender ATP.Default: —Range: —

Application ID

required
string—Default: "WDAV00"Range: WDAV00

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Edge.Default: —Range: —

Application ID

required
string—Default: "EDGE01"Range: EDGE01

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Excel.Default: —Range: —

Application ID

required
string—Default: "XCEL2019"Range: 2016 Volume License (XCEL15), 2019 Volume License/Office 365 (XCEL2019)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft OneNote.Default: —Range: —

Application ID

required
string—Default: "ONMC2019"Range: 2016 Volume License (ONMC15), 2019 Volume License/Office 365 (ONMC2019)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Outlook.Default: —Range: —

Application ID

required
string—Default: "OPIM2019"Range: 2016 Volume License (OPIM15), 2019 Volume License/Office 365 (OPIM2019)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft PowerPoint.Default: —Range: —

Application ID

required
string—Default: "PPT32019"Range: 2016 Volume License (PPT315), 2019 Volume License/Office 365 (PPT32019)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Windows App.Default: —Range: —

Application ID

required
string—Default: "MSRD10"Range: MSRD10

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —

Microsoft Remote Desktop

dictSchedule an update for Microsoft Remote Desktop.Default: —Range: —

Application ID

required
string—Default: "MSRD10"Range: MSRD10

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Teams.Default: —Range: —

Application ID

required
string—Default: "TEAMS10"Range: TEAMS10

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Microsoft Word.Default: —Range: —

Application ID

required
string—Default: "MSWD2019"Range: 2016 Volume License (MSWD15), 2019 Volume License/Office 365 (MSWD2019)

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Company Portal.Default: —Range: —

Application ID

required
string—Default: "IMCP01"Range: IMCP01

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for OneDrive.Default: —Range: —

Application ID

required
string—Default: "ONDR18"Range: ONDR18

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —
dictSchedule an update for Skype for Business.Default: —Range: —

Application ID

required
string—Default: "MSFB16"Range: MSFB16

Forced Update Date

required
dateThe date and time to force the update.Default: —Range: —

Forced Update Version

required
stringThe version of the update.Default: —Range: —