在 Microsoft 365 企业版 中配置 Microsoft AutoUpdate (MAU) 的首选项

作为Microsoft 365 企业版的管理员，你可以定制Microsoft AutoUpdate (MAU) 首选项，以满足用户的各种需求。 本文概述了 MAU 的首选项，并帮助你了解记录的可用首选项。

什么是 MAU 首选项？

MAU 首选项是允许自定义 Microsoft AutoUpdate 的行为的设置，该行为负责使Microsoft 365 应用程序保持最新状态。 通过设置这些首选项，可以管理更新频率和频道，确保用户能够接收最新功能和安全更新，同时尽量减少中断。

有关首选项及其部署的更多详细信息，请参阅部署Office for Mac的首选项。

IgnoreUIOpenAfterInstall

确定 MAU GUI 是在安装后启动还是更新后启动。 IT 管理员可以使用此设置阻止用户在更新后看到 MAU GUI。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	设置为 TRUE 时，MAU GUI 不会在安装或更新后启动。 注意：此设置不会阻止 MAU GUI 在自动检查模式下查找更新而启动。

AcknowledgedDataCollectionPolicy

存储用户对数据收集策略确认的选择。 此策略有助于确保用户了解数据收集策略。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值
管理	是
接受的值	RequiredDataOnly
Comments	未设置或错误设置此首选项会导致 (MAU) Microsoft AutoUpdate： 重复显示数据收集策略 不提供更新。

注意

RequiredAndOptionalData 现已弃用。 MAU 从未使用 RequiredAndOptionalData，仅将 RequiredDataOnly 用于首选项。 此首选项现已删除。

HowToCheck

指定 Microsoft AutoUpdate 检查更新的方式。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值	AutomaticDownload
管理	是
接受的值	AutomaticDownload AutomaticCheck 手动
Comments	如果没有此项或无效条目，MAU 将还原为默认的“AutomaticDownload”模式。 AutomaticDownload – MAU 定期检查更新并自动推送更新。 指示应用需要关闭才能完成更新，显示在应用中，或通过通知显示。 AutomaticCheck – MAU 定期检查更新，并在检测到可用更新时启动 GUI。 用户从 GUI 启动更新序列。 手动 - MAU 仅检查自己的更新，而不检查其他更新。 此选项将从 GUI 中删除。 设置为“手动”会导致 MAU 不自动提供更新。 以下值已弃用： 自动 - 替换为 AutomaticCheck 设置为“手动”会导致 MAU 不自动提供更新。

ChannelName

ChannelName 指定 AutoUpdate Microsoft接收更新的更新通道。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值	Current
管理	是
接受的值	Beta Current CurrentThrottle 自定义警报 预览
Comments	没有此条目或在 ChannelName 中具有无效条目，会将 MAU 还原为默认的“当前”通道。 以下值已弃用，不应再使用： 外部 (替换为预览) InsiderFast (替换为 Beta) 生产 (替换为当前) 注意：“自定义”设置旨在帮助组织在内部托管更新，从而减少外部网络流量。 在此方案中，IT 管理员负责： 管理组织内的服务器空间 将清单下载到指定的清单服务器位置 将更新包下载到指定的更新缓存位置 (（如果适用）) 频道说明： 当前 – 此通道分发所有官方版本，是默认设置。 CurrentThrottle - 创建以允许用户跳过当前频道中的“每周”Outlook 版本。 其他应用通过当前频道更新， (默认) 。 自定义 – 要利用内部服务器时要使用的通道。 预览 – 此频道提供官方版本的预览。 Microsoft 365 个应用通常在正式发布前两周推出。 Beta 版 - 开发中绝对最新。 Microsoft 365 个应用每周更新两次。 仅用于测试和错误报告目的。 产品支持可能在此频道中不可用。 有关预览版和 Beta 版频道的详细信息，请参阅 比较 Microsoft 365 预览体验成员频道 和 让 Mac 用户通过使用 Microsoft AutoUpdate (MAU) 来自行选择 Microsoft 365 预览体验成员 。

有关 Per-App 通道的注释：可以通过向需要不同通道的特定应用程序添加 ChannelName 键和值来为每个应用指定 ChannelName。 例如，以下 XML 代码片段演示如何将 Excel 的通道设置为“当前”，并将其他所有通道设置为 Beta 版：

<key>Applications</key>
<dict>  
        <key>/Applications/Microsoft Excel.app</key>
        <dict>  
                <key>Application ID</key>
                <string>XCEL2019</string>
                <key>ChannelName</key>
                <string>Current</string>
        </dict>
      ......
</dict>
<key>ChannelName</key>
<string>Beta</string>

ManifestServer

ManifestServer 是托管更新清单的服务器 URL。 当 ChannelName 设置为“自定义”时，MAU 会从此位置下载更新清单。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值
管理	是
Comments	必须指向托管更新清单文件的有效 URL。 要托管的文件列表包括： .xml -chk.xml 。猫 -history.xml 注意： ChannelName 应设置为“自定义”，以便有意义地使用此首选项。 如果 ChannelName 设置为 Custom 且未配置此首选项，则 MAU 默认为“当前通道”。 可通过以下 URL 访问最新发布的清单文件，该 URL 用作当前通道的根 URL： https://officecdnmac.microsoft.com/pr/C1297A47-86C4-4C1F-97FA-950631F94777/MacAutoupdate/ 将实际文件名追加到提供的 URL;URL 不包含目录列表。 填充 ManifestServer 时，请确保复制所有附件，包括每个应用的以下文件： .xml -chk.xml 。猫 -history.xml 此外，请确保复制所有受版本控制清单。 版本列在 –history.xml 文件中，文件名 (.xml.cat) 需要使用 4090<AppID>_<Version> 构造。[xml |cat]，否则 MAU 提供的某些功能可能不可用。

UpdateCache

托管实际更新包的服务器 URL。 MAU 从此位置下载更新包，而不是 .xml 清单文件中指定的位置。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值
管理	是
Comments	将 UpdateCache 设置为将客户端流量定向到内部更新服务器，从而减少高外部下载流量。 如果正确的更新包不在此位置，则报告“下载错误”。 若要填充 UpdateCache，请复制所有 updater 包。 可以通过检查每个应用程序的 .xml 文件的内容（例如当前频道中的 0409MSWD2019.xml）来查找这些包。

EnableFallbackChannel

如果指定的通道 (Beta、预览版、自定义) 没有已注册应用程序的清单，则允许Microsoft AutoUpdate 在当前通道中查找更新。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	TRUE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	如果设置了 ManifestServer 位置，但无法复制所有已注册应用程序的清单，EnableFallbackChannel 非常有用。 如果不想使用当前通道作为备份，请将此首选项设置为 FALSE。

DisableOptInNotification

设置为 TRUE 时，即使 HowToCheck 设置为“自动”，也会阻止 Opt-In 通知/弹出窗口显示。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	如果此项缺失或设置为 FALSE，并且 HowToCheck 设置为“自动”，将显示 Opt-In 弹出窗口。 如果 HowToCheck 设置不是“自动”，则忽略此通知。

下面是通知和弹出窗口的示例：

LastUpdate

请勿使用。 MAU 使用此首选项跟踪上次更新检查。 它仅在至少 12 小时后检查更新。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	日期
默认值
管理	否
Comments	重要 不要在托管配置文件中包含此条目。 通过托管配置文件设置此值会产生以下后果： 如果设置为 future，则 MAU 仅在 12 小时后检查更新。 如果设置为“已过”或格式不正确，则 MAU 每两小时检查一次更新。

DisableVoiceOverAccessibility

荒废的。 如果设置为 TRUE，则会导致在自动更新Microsoft禁用 VoiceOver 辅助功能。 此选项已弃用。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
Comments	已从 MAU 4.70 弃用。

ReopenAfterGUIInstall

请勿使用 如果设置为 TRUE，则 MAU GUI 将在更新后首次启动 MAU 期间打开。 在更新后 MAU GUI 的初始启动后，将删除此首选项。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	否
Comments	重要 此首选项仅由 MAU 本身使用，不应包含在托管配置文件中。 在托管配置文件中将此首选项设置为 TRUE 会导致在每次启动 FBA) 进程启动 (首次启动身份验证时打开 MAU GUI。

ManifestServerExpiryDate

请勿使用。 设置 ManifestServer 设置过期的日期。 当前仅由 Teams21 使用。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	日期
默认值
管理	否
Comments	当前仅由 Teams21 使用。 在指定的日期之后，将删除 ManifestServer 条目，有效地还原更新以改用当前 (默认) 通道。

应用程序

Lists应用程序注册。 此字典可以包含特定应用程序的键以及应如何更新它们的详细信息。 对于基于每个应用程序管理更新非常有用。

注意

有关受支持的 AppID 的列表，请参阅 应用程序标识符。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	Dictionary
默认值
管理	是
Comments	如果未列出某个应用，并且用户从未启动过该应用，则永远不会更新该应用。 注意：LCID 条目现已弃用。 从历史上看，LCID 是应用程序字典条目中的应用程序记录的一部分。 标识的语言代码，用于查找特定于语言的更新清单。 不再适用。 可添加到此字典的其他键/值对记录在 “应用域 ”部分中。

示例：

<key>Applications</key>
<dict>  
        <key>/Applications/Microsoft Excel.app</key>
        <dict>  
                <key>Application ID</key>
                <string>XCEL2019</string>
        </dict> 
        <key>/Applications/Microsoft Outlook.app</key>
        <dict>  
                <key>Application ID</key>
                <string>OPIM2019</string>
        </dict> 
        <key>/Applications/Microsoft PowerPoint.app</key>
        <dict>  
                <key>Application ID</key>
                <string>PPT32019</string>
        </dict> 
</dict>

应用域

由 MAU 用于搜索更新路径的额外信息。 有关详细信息，请参阅 设置 Office 许可证信息以获取Microsoft AutoUpdate 的更新。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值
管理	是
Comments

示例：

<key>Applications</key>
<dict>  
        <key>/Applications/Microsoft Excel.app</key>
        <dict>  
                <key>Application ID</key>
                <string>XCEL2019</string>
                <key>Install Priority</key>
                <string>High</string>
                <key>App Domain</key>
                <string>com.microsoft.office</string>
        </dict> 
</dict>

ApplicationsSystem

请勿使用。 MAU 使用的内部字典，使多用户设备上的用户之间保持应用程序字典同步。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	Dictionary
默认值
管理	否
Comments	设置此首选项可能与应用程序字典冲突。 建议不要设置它。 注意： 此首选项可帮助 MAU 在内部协调由不同用户安装或注册的各种应用程序。 IT 管理员可以使用此首选项来确保设备上的所有用户都收到相同的应用程序更新。 重要： 此首选项必须包括设备上安装的 MAU 支持的所有Microsoft应用程序。 不要在托管配置文件中设置。

HideOnGUI

应用程序字典中的应用程序记录的一部分。

当在应用程序记录中设置为 TRUE 时，应用程序不会显示在 MAU GUI 上。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	此设置应应用于不应显示在 MAU GUI 中的任何应用。 示例包括： OLIC02 – 许可帮助程序 当 HowToCheck 设置为 AutomaticCheck 时，设置此选项可防止通过 GUI 更新应用。

UpdateReadyReminderIntervalInHours

由 Microsoft 365 个应用用于确定更新就绪消息栏的显示频率。 单位为小时。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值
管理	是
接受的值	12 - 168
Comments	更新就绪提醒最多可以忽略七天。

下面是 Excel 中“更新就绪”消息栏的示例：

AppCustomPref

Microsoft 365 个应用程序 (>= 16.79) 写入许可证相关信息。

MAU 使用此信息提供正确的产品更新。

有关详细信息，请参阅： 设置Microsoft自动更新更新的 Office 许可证信息 - 部署 Office |Microsoft Learn

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	Dictionary
默认值
管理	是
Comments	错误地设置此选项会阻止Microsoft 365 应用的更新。

OptionalUpdatesDeferralsDays

这定义了在发布更新后等待提供/安装更新的天数。

有关详细信息，请参阅：Microsoft自动更新和延迟汇报

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值
管理	是
接受的值	1 - 28
Comments	此值的容差为三天。 设置此值时，IT 管理员应在所需的延迟天数中添加三天。

OptionalUpdatesDeferrals

包含单个应用延迟天数/版本的字典。

有关详细信息，请参阅：Microsoft自动更新和延迟汇报

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	Dictionary
默认值
管理	是
Comments

DisableEndOfSupportNotifications

设置为 TRUE 时，禁用有关终止 Office 套件支持的通知。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments

DisableInsiderCheckbox

如果设置为 TRUE，则用于禁用下拉菜单以选择 Beta/预览频道。

注意

名称是历史的，从复选框控制注册到预览体验计划的时间。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
Comments	应用于禁用最终用户的频道选择。

EnableCheckForUpdatesButton

如果设置为 FALSE，则会禁用为 MAU GUI 中的更新启动检查的选项。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	TRUE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	如果不应允许单个用户启动更新检查或自行启动更新，IT 管理员应将此设置为 FALSE。 注意：当 MAU 完成更新检查时，“检查汇报”按钮将替换为“全部更新”按钮。 当设置为 FALSE 时，此首选项键也会禁用“全部更新”按钮。

ExtendedLogging

如果设置为 TRUE，则会导致将详细日志记录输出到 MAU 日志文件。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	MAU 日志将仅保留最后 1MB。 此设置可能会导致本地日志文件丢失详细信息。

UpdateCheckInterval

指定检查更新之间的分钟数。 默认值设置为每 13 小时检查一次。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值	780
管理	是
Comments	默认为 13 小时间隔。 建议此数字为 60 (1 小时) 的倍数。 建议) 三天不超过 4320 (。

UpdateCheckFrequency

已弃用。 错误地命名。 已更改为 UpdateCheckInterval，以更准确地描述其功能。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值
管理
Comments	不推荐使用

UpdateDeadline.ApplicationsForcedUpdateSchedule

字典，其中包含指定应用程序的强制更新计划的字典条目列表。 此设置用于在特定日期前强制实施更新，确保所有设备运行最新的软件版本。

有关更多详细信息 ，请参阅设置来自 Microsoft AutoUpdate 的更新的截止时间 。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	Dictionary
默认值
管理	是
Comments	应设置为在特定日期前强制实施更新。

示例：

<dict>
    <key>path to the application</key>
    <dict>
        <key>"Application ID"</key>
        <String>OPIM2019</String>
        <key>"ForcedUpdateDate"</key>
        <Date>2024-04-01</Date>
        <key>"ForcedUpdateVersion"</key>
        <String>16.84.24032800</String>    
    </dict>
</dict>

UpdateDeadline.DaysBeforeForcedQuit

若要配置在检测到更新后的一定天数的截止时间，请使用以下首选项设置。

有关详细信息，请参阅： 为Microsoft AutoUpdate 的更新设置截止时间

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值
管理	是
Comments	MAU 基于在该设备上找到更新的日期计算截止时间。 不是从Microsoft发布修补程序的时间。 从 StartAutomaticUpdate 到截止时间之前的天数开始，每 12 小时向用户显示一条提示

下面是显示的提示示例。

UpdateDeadline.FinalCountDown

将在截止时间日期之前显示“强制更新”对话框之前的分钟数。

有关详细信息，请参阅： 为Microsoft AutoUpdate 的更新设置截止时间

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值	60
管理	是
Comments	此值的范围是 10 到 720。 从 FinalCountDown 开始，即截止时间前的分钟数，MAU 每次运行时都会向用户显示提示。 达到倒计时后，应用程序会自动关闭。

下面是显示的提示示例。

UpdateDeadline.StartAutomaticUpdates

在强制更新日期之前，MAU 会将每个更新视为 AutomaticDownload 的天数。

使用此首选项设置可为 MAU 启用自动下载和安装模式，而不管设备上的当前 MAU HowToCheck 设置如何。 到达截止时间后，MAU 将还原设备上的上一个设置。

有关详细信息，请参阅： 为Microsoft AutoUpdate 的更新设置截止时间

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	整数
默认值	3
管理	是
Comments	小于 3 的值被视为 3。 值不能大于 DaysBeforeForcedQuit。

UpdateDeadline.DialogTitle

用于显示“强制更新”对话框的自定义标题。

有关详细信息，请参阅： 为Microsoft AutoUpdate 的更新设置截止时间

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值	管理员已设置更新的截止时间。
管理	是
Comments

UpdaterOptimization

确定是针对 Office 应用汇报的较小下载大小 (默认) 还是更快的后台安装时间进行优化。

其中之一：大小、网络、CPU 或无。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	String
默认值	Size
管理	是
接受的值	Size 网络 CPU None
Comments	将此值设置为“无”会导致下载完整更新程序，从而影响网络使用情况。 除非有理由使用完整更新程序，否则此值应留空，或设置为 Size。

GuardAgainstAppModification

将此首选项设置为 TRUE 会始终将应用程序的克隆保留在缓存位置。

需要，因为某些安全应用正在修改 /Applications 文件夹下安装的应用，导致更新失败。

类别	详细信息
Domain	com.microsoft.autoupdate2
类型	布尔值
默认值	FALSE
管理	是
接受的值	TRUE / FALSE / 1 / 0
Comments	如果你的组织使用修改已安装应用的安全应用，请使用此首选项。 怀疑安全应用修改已安装应用的指示会频繁出现更新失败，导致所有 Microsoft 365 应用的完整更新程序下载。 Office 应用更新以“二进制增量”更新的形式提供，其中仅更新已更改的位。 拥有修改实际安装的应用程序的安全应用将导致每次二进制增量更新后验证失败，从而强制下载完整的更新程序包。 可以通过从终端应用运行以下验证来判断应用是否已修改。 如果应用程序的完整性受到损害，则此作将失败： codesign –vv --deep <<path to the app>>