使用 Office 部署工具 (ODT) ，可以将Microsoft 365 应用版下载并部署到客户端计算机。 使用 ODT，可更好地控制 Office 安装：可以定义要安装哪些产品和语言、应该如何更新这些产品以及是否向用户显示安装体验。 本文介绍此工具中的所有可用选项。 若要了解如何使用该工具本身，请参阅 Office 部署工具概述。

注意

最佳做法： 本文中的选项显示了配置文件中的 XML 元素和属性。 可以继续在文本编辑器中创建配置文件，但我们建议改用 Office 自定义工具 。 使用 Office 自定义工具，可以在基于 Web 的界面中轻松创建和修改配置文件。 有关详细信息，请参阅 Office 自定义工具概述。

ODT 包含 2 个文件：setup.exe 和 configuration.xml。 若要使用该工具，请编辑配置文件以定义所需选项，然后从命令行运行 setup.exe。 例如，可以编辑配置文件以下载 64 位英语版 Office，也可以编辑该文件以安装 64 位英语版 Office，且 EULA 自动接受且没有发布服务器。

创建配置文件时，建议从示例文件开始，并使用适合你的环境的恰当选项更新该文件。 首先，可将以下示例复制并粘贴到文本文件，然后选择一个名称将其保存。 使用 文件修改 XML 元素和属性，并使用本文的其余部分了解有关每个元素和属性的更多详细信息。

此配置文件包含最常用的元素和属性，可用于下载并将 Office 安装到客户端计算机

注意

不再支持将 Logging 元素作为 Office 部署工具的配置选项。 可以在用户的 %temp% 文件夹以及 C：\Windows\Temp 中找到日志文件。

定义要下载或安装的产品和语言

可选。

定义 Office 安装文件的位置。 如果 ODT 在下载模式下运行，则定义用于保存文件的位置。 如果未包含在内，ODT 将在工具所在的文件夹中查找安装文件，然后使用 Office 内容分发网络 (CDN) 。 如果不包括且 ODT 在下载模式下运行，Office 安装文件会下载到工具所在的文件夹中。

将 Office 下载到已包含该版本的 Office 的文件夹时，ODT 通过仅下载缺少的文件来节省网络带宽。 例如，如果使用 ODT 将 Office 英语和德语下载到已包含 Office 英语的文件夹，则仅下载德语语言包。

示例值：

SourcePath 值不应包括 /Office 部件或下载 Office 数据的文件夹的名称。

可选。 如果未指定，则默认为可用的最新版本。

使用 Version 属性时，建议也包括 Channel 属性。 如果未包含 Channel 属性，则使用默认通道，这可能与指定的版本不匹配。

如果设备上已安装Microsoft 365 应用版，则可以使用 Version=“MatchInstalled”安装相同版本的 Office，即使有较新的版本可用也是如此。 此设置可以更轻松地添加语言包或 Visio 和 Project，而无需将 Office 更新到较新版本。

示例值：

可选。

定义是下载还是安装 32 位或 64 位版本的 Microsoft 365 应用版。 如果设备上未安装 Office 且未指定 OfficeClientEdition，则 ODT 默认为 64 位版本，除非设备运行的是 32 位版本的 Windows 或 RAM 小于 4 GB。 如果已安装 Office 且未指定 OfficeClientEdition，则 ODT 与 Office 现有安装的体系结构匹配。 如果已安装 Office 并指定了 OfficeClientEdition，则它必须与已安装的体系结构匹配。 否则，安装会失败，因为不支持混合体系结构。

允许值：

可选。

定义用于安装 Office 的通道。 如果设备上未安装 Office，则 Channel 属性的默认设置为 Current。 如果在设备上安装了 Office 并且未指定通道属性，则 ODT 与现有安装的通道匹配。

此值确定要安装的通道，而不管 汇报 元素中的可选指定更新通道，还是通过 组策略 设置。 如果存在具有不同更新通道的此类设置，则会在下一个更新周期安装后执行通道切换。 有关详细信息，请参阅更改Microsoft 365 应用版更新通道。

有关更新频道的详细信息，请参阅 Microsoft 365 应用版的更新频道概述。

允许的值：

注意

如果要部署 Office LTSC 专业增强版 2021 或 Office LTSC 标准版 2021（即 Office 的批量许可版本），则需要使用其他更新通道：永久 VL2021。 有关详细信息，请参阅 Office LTSC 2021 的更新频道。

如果要部署 Office 专业增强版 2019 或 Office Standard 2019（即批量许可版本的 Office），则需要使用其他更新通道：永久VL2019。 有关详细信息，请参阅 Office 2019 的更新频道。

可选。 如果未指定，则默认为 CDN。

定义在下载模式下运行 ODT 时从中下载安装文件的位置。 最常用于将适用于 Office 的特定语言及相关产品从网络上的某一中心位置分发到另一个位置。 使用 DownloadPath 时，必须指定版本，如示例中所示。

示例值：

可选。 如果未指定，则默认为 False。

若要将 Office CDN 用作语言包的备份源，请在配置文件中包含“AllowCdnFallback”属性，如示例中所示。

安装语言时，ODT 首先查找 SourcePath 属性中指定的位置中的源文件。 如果语言包在该位置不可用， 并且 AllowCdnFallback 设置设置为 True，则 ODT 将使用 Office CDN 中的源文件。

允许值：

可选。 如果未指定，则默认为 False。

如果设置为 TRUE，则Microsoft 365 应用版的现有安装将更改为体系结构 (有时称为在 OfficeClientEdition 属性中指定的位数) 。 例如，可以使用此属性将 32 位安装的 Microsoft 365 应用版 更改为 64 位安装。

有关使用 MigrateArch 的详细信息，请参阅将Microsoft 365 应用版安装从 32 位更改为 64 位。

可选。 如果未指定，则默认为 False。

如果设置为 True，则会注册一个 COM 对象，这是允许更新管理解决方案 (例如 Microsoft Configuration Manager) 管理 Office 更新所必需的。 使用 Configuration Manager 进行Microsoft 365 应用版更新时是必需的。 启用 Office COM 对象后，“帐户”页上的“Microsoft 365 应用版”选项会自动禁用客户端设备。

有关详细信息，请参阅使用 Microsoft Configuration Manager 管理Microsoft 365 应用版的更新。

允许的值：

定义要下载或安装的产品。 如果定义了多个产品，则按配置文件中的顺序安装这些产品。 第一个产品确定 Microsoft Office 首次运行体验的上下文。

还可以使用 Product 元素将语言包添加到Microsoft 365 应用版的现有安装。 有关详细信息（包括示例配置文件），请参阅将语言部署到Microsoft 365 应用版的现有安装。

必填。

定义要下载或安装的产品的 ID。

示例值：

有关所有支持的产品 ID 的列表，请参阅即点即用 Office 部署工具支持的产品 ID

可选。

允许根据设备上是否已安装基于特定 MSI 的 Office 产品来控制 由 ID 属性指定的 Office 产品的安装。 例如，如果设备上已安装基于 MSI 的 Project Professional 版本，则安装Project Online桌面客户端。

你可以指定 Windows Installer (MSI) 安装的任何 Office 产品，但 MSICondition 最常用于 Project 或 Visio 安装。 为 MSICondition 属性指定的值可以是产品的批量许可版本或零售版本，前提是该版本的产品是使用 MSI 安装的。

MSICondition 可识别您指定的 Office 产品的 2007、2010、2013 和 2016 版本。 但是，不能指定特定版本。 例如，不能让 MSICondition 专门查找 Visio Standard 2013。 MSICondition 查找所有基于 MSI 的Visio Standard安装，包括 Visio Standard 2007、Visio Standard 2010、Visio Standard 2013 和 Visio Standard 2016。

为 MSICondition 属性指定的值是在 {product} 的 Setup.xml 文件中找到的安装程序 ID。Office 产品现有版本的安装文件的 WW 文件夹。 例如，Visio 专业版 2016的Setup.xml文件位于 VisPro.WW 文件夹中。 可以指定多种类型的 Office 产品，用逗号分隔。 例如，可以指定“PrjStd、PrjStdR、PrjPro、PrjProR”来查找Project Standard或Project Professional（批量许可或零售）的安装。

注意

建议在安装 XML 文件中指定的产品时删除基于 MSI 的现有 Office 产品。 若要删除基于 MSI 的现有产品，请使用 RemoveMSI 元素。

还可以watch视频，了解如何将 MSICondition 与 RemoveMSI 结合使用以简化升级。

在以下示例中，仅当设备上已安装基于 MSI 的 Project Standard 版本时，才会在设备上安装Project Online桌面客户端。 此外，Project Online桌面客户端安装过程中，将从设备中删除Project Standard。

定义要下载或安装的语言。 如果定义了多个语言，则配置文件中的第一个语言确定 Shell UI 区域性，包括快捷方式、右键单击上下文菜单和工具提示。 如果决定在初始安装后更改 Shell UI 语言，则必须卸载并重新安装 Office。

必填。

定义要下载或安装的语言的 ID。

请确保所安装的产品支持你指定的语言。 否则，安装将失败。

例如，Microsoft 365 应用版支持英语 (英国) 、法语 (加拿大) 和西班牙语 (墨西哥) ，但 Project 和 Visio 不支持这些语言。

有关 MatchPreviousMSI 的详细信息，请参阅升级到 Microsoft 365 应用版 时删除 Office 的现有 MSI 版本。

如果 Office 不支持该语言，或者 ODT 在本地源文件中找不到正确的语言包，则 MatchOS 和 MatchInstalled 无法安装操作系统语言。 为了帮助解决此问题，建议指定备份语言并允许 ODT 使用 Office CDN 来处理缺少的文件。 为此，请使用 Fallback 属性和 AllowCdnFallBack 属性。

仅当已安装至少一个即点即用产品时，才能使用 MatchInstalled。 它不能与 ODT 的 /download 开关一起使用。 有关 MatchInstalled 的详细信息，请参阅部署语言概述和为Microsoft 365 应用版生成动态、精益和通用包。

可选。

使用 MatchOS 时，建议指定在 Office 不支持匹配语言或在本地源文件中找不到匹配语言时要安装的回退语言。 为此，请使用“回退”属性。 有关详细信息，请参阅 安装与操作系统相同的语言。

示例值：

可选。

使用 MatchInstalled 时，可以指定是要匹配特定产品的已安装语言列表，还是要匹配所有已安装产品的组合。 若要面向特定产品，可以指定任何 受支持的产品 ID。 如果要匹配所有已安装产品的语言，请指定“All”。 然后，ODT 使用与 TargetProduct 中指定的语言相同的语言集安装新产品。

如果未使用 MatchInstalled 指定 TargetProduct，则 ODT 会尝试匹配配置文件中语言标记所属的同一产品 ID。 例如，如果在不使用 TargetProduct 的情况下安装“VisioProRetail”时使用 MatchInstalled，则 ODT 会尝试匹配此产品已安装的语言。

示例值：

定义安装 Office 时用户看到的内容。

可选。 如果未指定，则默认值设置为 Full 。

如果 “级别 ”设置为 “无”，则安装 Office 时没有用户界面：不显示进度栏、完成屏幕、错误消息或其他用户界面。

如果 Level 设置为 Full，安装 Office 时将提供正常安装体验。

允许值：

可选。 如果未指定，则默认为 FALSE 。

如果 AcceptEULA 设置为 TRUE，则用户不会看到“Microsoft 软件许可条款”对话框。 如果此属性设置为 FALSE 或未包含在内，则用户可能会看到“Microsoft 软件许可条款”对话框。 建议管理员将 AcceptEULA 设置为 TRUE 。

允许值：

注意

如果部署版本 1803 之前的 Office 版本，则仅当使用用户帐户进行安装时，才会应用此设置。 Microsoft Configuration Manager 和其他使用 SYSTEM 帐户进行安装的软件分发工具将不应用此设置。

定义不应安装哪些Microsoft 365 应用版产品。 当你安装Microsoft 365 应用版或安装单个应用程序（如 Word、Excel、PowerPoint、Publisher、Visio 或 Skype）时，将自动安装 OneDrive。 如果不希望随这些应用程序一起安装 OneDrive，请使用 ExcludeApp 元素将其删除。 有关详细信息，请参阅安装Microsoft 365 应用版或其他应用程序时排除 OneDrive。

如果使用 ExcludeApp 的配置文件在已安装Microsoft 365 应用版的设备上安装 Office，则会根据语言列表以不同的方式处理 ExcludeApp 设置：

必填。

定义不应安装的产品的 ID。

允许值：

注意

定义特定 Office 行为和属性。

必填。

定义要设置其值的特定属性。

定义命名属性的值。

可选。 如果未指定，则默认值为 0 。

由于Microsoft 365 应用版设置为自动激活，因此不应为Microsoft 365 应用版产品设置此属性。 对于其他产品，可以将 AUTOACTIVATE 设置为 1 以自动激活该产品。

允许的值：

可选。 如果未指定 ， 则默认值为 FALSE。

设置为 TRUE 时，强制关闭阻止安装 Office 的所有应用。 可能发生数据丢失。

允许的值：

可选。

默认情况下，ODT 创建的 App-V 包共享相同的 App-V 包 ID。 管理员可以使用 PACKAGEGUID 指定其他包 ID 。 这允许将 Office 的多个 App-V 包发布到 App-V 管理服务器。 但是，不能通过此选项将多个 Office App-V 包部署到单台计算机。 可以使用 ODT 为Microsoft 365 应用版创建 App-V 包。 不支持为 Office Professional Plus 或 Office Standard 的批量许可版本创建包。

包 ID 必须遵循示例中的格式，并且只能使用下面这些字符：0、1、2、3、4、5、6、7、8、9、A、B、C、D、E、F

如果使用其他任何字符，创建的 APP-V 包使用默认包 ID。

示例值：

可选。 如果未指定，则默认值为 0 。

如果使用远程桌面服务将 sharedComputerLicensing Microsoft 365 应用版部署到共享计算机，请将 SharedComputerLicensing 设置为 1。

有关详细信息，请参阅Microsoft 365 应用版的共享计算机激活概述。

允许值：

可选。 如果未指定，则默认值为 0 。

如果使用共享计算机激活并且想要漫游许可令牌，请将 SCLCacheOverride 设置为 1。 将此属性与 SCLCacheOverrideDirectory 配合使用。 仅当选择从其默认位置移动许可令牌时，才需要此属性。 有关详细信息，请参阅Microsoft 365 应用版的共享计算机激活概述。

允许值：

可选。

如果使用的是共享计算机激活并且想要漫游许可令牌，请将 SCLCacheOverrideDirectory 设置为指定许可令牌的文件夹位置。 将 属性与 SCLCacheOverride 一起使用。 仅当选择从其默认位置移动许可令牌时，才需要此属性。

有关详细信息，请参阅Microsoft 365 应用版的共享计算机激活概述。

示例值：

可选。 如果未指定，则默认值为 0 。

定义基于设备的激活的 Office 许可模式。 有关详细信息，请参阅用于Microsoft 365 企业应用版的基于设备的许可。

允许的值：

可选。 如果未指定，则默认值为 True 。

定义是否将 Office 产品的快捷图标添加到 Windows 7 中的 Windows 任务栏并Windows 8.1。 如果使用系统帐户安装 Office（使用 Microsoft Configuration Manager 进行部署时很常见），即使此属性设置为 True，也不会固定图标。

允许的值：

注意

定义要从以前安装的 Microsoft 365 应用版 中删除的产品和语言。 若要删除已安装的语言，必须同时提供产品和语言，如示例所示。 若要删除所有已安装的语言，请不要包含语言属性。 在这种情况下，ODT 会自动发现并删除产品的所有已安装语言。

有关详细信息，请参阅 Office 部署工具概述。

可选。 如果未指定，则默认值为 FALSE 。

如果设置为 TRUE，则删除所有Microsoft 365 应用版产品和语言，包括 Project 和 Visio。

允许值：

定义如何在安装后更新 Office。

可选。 如果未指定，则默认值为 TRUE 。

如果设置为 TRUE，Office 会检查更新。 如果设置为 FALSE，则 Office 不会检查更新，但用户可以通过转到“文件>帐户>更新选项>立即更新”来检查更新。

允许值：

可选。 如果未指定，则默认为 CDN。

定义 Office 更新的来自何处。 UpdatePath 可以为 Office 安装文件源指定网络、本地或 HTTP 路径。 可将环境变量用于网络或本地路径。

如果将 组策略 用于 Office 的管理模板文件 (ADMX/ADML) ，则可以使用更新路径策略设置来设置 UpdatePath。 您可以在“Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates”下找到此策略设置。

示例值：

可选。 默认为指定更新路径中的最新版本。

定义 Office 更新到的版本。 如果 TargetVersion 设置为特定内部版本号，Office 会尝试更新到该版本。

如果将 组策略 用于 Office 的管理模板文件 (ADMX/ADML) ，则可以使用目标版本策略设置来设置 TargetVersion。 您可以在“Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates”下找到此策略设置。

示例值：

可选。

定义必须应用更新的截止时间。 截止时间以协调世界时 (UTC) 中指定。 可以配合使用 Deadline 和 Target Version 确保在特定日期之前将 Office 更新到特定版本。 建议将截止时间至少设置为一周后，以便为用户留出时间来安装更新。

用户将在截止时间之前收到多个安装更新的提醒。 如果未在截止时间之前更新 Office，用户会看到一个通知，指示将在 15 分钟后更新。 此通知使用户有机会保存他们正在处理的 Office 文档，并关闭任何打开的 Office 程序。 如果用户未关闭 Office 程序，则程序会在 15 分钟后自动关闭，这可能导致数据丢失。

关闭 Office 程序后，将自动进行更新。 截止时间仅适用于一组更新。 如果要使用截止时间来确保 Office 始终处于最新状态，则必须在每次有新的 Office 更新可用时更改截止时间。

若要使用此属性，Office 必须至少运行 Service Pack 1（版本 15.0.4569.1507）。 如果将 组策略 用于 Office (ADMX/ADML) 的管理模板文件，则可以使用更新截止时间策略设置来设置截止时间。 您可以在“Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates”下找到此策略设置。

示例值：

可选。 默认值为 Current。

定义安装后用于更新 Office 的通道。 有两个通道属性：Add 元素的通道用于在安装 Office 时指定更新通道，汇报 元素的通道用于更改 Office 现有安装的通道。

有关更新频道的详细信息，请参阅 Microsoft 365 应用版的更新频道概述。

如果将 组策略 用于 Office 的管理模板文件 (ADMX/ADML) ，则可以使用更新通道策略设置来设置通道。 您可以在“Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates”下找到此策略设置。 如已启用，则此组策略设置优先于使用 Office 部署工具设置的 Channel 值。

允许的值：

注意

如果要部署 Office LTSC 专业增强版 2021 或 Office LTSC 标准版 2021（即 Office 的批量许可版本），则需要使用其他更新通道：永久 VL2021。 有关详细信息，请参阅 Office LTSC 2021 的更新频道。

如果要部署 Office 专业增强版 2019 或 Office Standard 2019（即批量许可版本的 Office），则需要使用其他更新通道：永久VL2019。 有关详细信息，请参阅 Office 2019 的更新频道。

可选。

指定在安装指定产品（如Microsoft 365 应用版）之前，是否从计算机中卸载使用 Windows Installer (MSI) 安装的任何 2007、2010、2013 或 2016 版本的 Office、Visio 和 Project。

建议在安装Microsoft 365 应用版之前卸载任何早期版本的 Office。 有关使用 RemoveMSI 的详细信息，请参阅在升级到 Microsoft 365 应用版 时删除 Office 的现有 MSI 版本。

可选。

如果指定了 ID，则不会从计算机中卸载 Windows Installer (MSI) 产品。

示例值：

可选。

定义Microsoft 365 应用版的应用程序首选项，包括 VBA 宏通知、默认文件位置和默认文件格式。 若要创建具有应用程序首选项的配置文件，建议使用 即点即用 Office 自定义工具，这是一个具有完整用户界面的 Web 应用程序。 还可以使用 该工具了解有关可用应用程序首选项的详细信息。

有关应用程序首选项的详细信息，请参阅 应用应用程序首选项 和 将应用程序首选项应用于 Office 的现有安装。