通过

在 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 设置不是“自动”，则忽略此通知。

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

询问“启用自动汇报？”的通知弹出窗口，并显示“始终安装Microsoft应用的新功能和更新”以及Microsoft应用的图标。

Microsoft更新对话框的屏幕截图，标题为“启用自动汇报”，并简要介绍了Microsoft发布新功能、安全更新和改进。该框包含蓝色的“打开”按钮和下方的“不立即”链接。

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 中“更新就绪”消息栏的示例：

Microsoft Excel 的界面显示“更新可用”通知，指示进行了一些修复和改进，并提示重启应用。显示的 Excel 工作簿名为“Book1”，工作表“Sheet1”可见，当前为空白，未输入任何数据。

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 应用于禁用最终用户的频道选择。

“首选项”窗格的屏幕截图，其中显示了Microsoft软件更新的选项。它包括设置为“当前频道”的“更新通道”下拉列表，其中包含说明它提供完全支持的更新的文本，以及一个“自动汇报”部分，其中包含一个复选框，指出“自动下载和安装”，指示Microsoft应用的更新设置为自动安装。

EnableCheckForUpdatesButton

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

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

Microsoft“自动更新”窗口，其中显示“所有应用都是最新的”。下方有一个选项“自动使Microsoft应用保持最新”，旁边还有一个可单击的“检查汇报”按钮和“高级”选项链接。

Microsoft Mac 上的 AutoUpdate 界面，显示“所有应用都处于最新状态”的消息。它具有未选中的“自动使Microsoft应用保持最新”复选框，其中“检查汇报”和“高级...”按钮设置可见。

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 小时向用户显示一条提示

下面是显示的提示示例。 Microsoft自动更新提醒弹出窗口，其中包含日期“2019 年 7 月 27 日”。它会通知用户管理员已设置更新的截止时间，并指示在截止时间之前保存数据并退出以下应用，并显示Microsoft Word图标。弹出窗口底部有“暂停”或“更新”选项。

UpdateDeadline.FinalCountDown

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

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

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

下面是显示的提示示例。 Microsoft自动更新通知的特写，倒计时计时器设置为 59 分 53 秒。消息指出“管理员已设置更新截止时间”，并建议用户在截止时间之前保存其数据并关闭以下应用，并显示Microsoft Word图标。底部的按钮显示“退出应用和更新”。

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 Microsoft自动更新警报，其中红框突出显示了一条重要通知，上面写着“管理员已设置更新截止时间，日期为”2019 年 7 月 27 日”。下面是在截止时间之前保存数据和关闭应用的说明，其中包含Microsoft Word图标，并附带“暂停”和“更新”按钮。还有其他推迟选项可在一小时、12 小时、明天或两天内重试。

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