Office 部署工具的配置选项

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

注意

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

标准配置文件示例

ODT 包含 2 个文件：setup.exe 和 configuration.xml。 若要使用该工具，请编辑配置文件以定义所需选项，然后从命令行运行 setup.exe。 例如，可以编辑配置文件以下载 64 位英文版的 Microsoft 365 应用版，也可以编辑配置文件以安装 64 位英文版的 Microsoft 365 应用版，最终用户许可协议 (EU) LA 自动接受且无需 Publisher。

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

此配置文件包括最常用的元素和属性，可用于在客户端计算机上下载和安装 Microsoft 365 应用版。

<Configuration>
  <Add SourcePath="\\Server\Share" 
       OfficeClientEdition="64"
       Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
    <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
  </Add>
  <Updates Enabled="TRUE" 
           UpdatePath="\\Server\Share" />
   <Display Level="None" AcceptEULA="TRUE" />  
</Configuration>

值	说明
添加 SourcePath=“\\Server\Share”	Office 将下载到网络上的“\\server\share”，并使用该位置的安装文件进行部署。
Add OfficeClientEdition=“64”	下载并安装 64 位版本的 Office
添加 Channel=“MonthlyEnterprise”	Office 使用每月企业频道进行安装。
Product ID="O365ProPlusRetail"	下载并安装 Microsoft 365 企业应用版。
Language ID="en-us" Language ID="ja-jp"	下载并安装英语版和日语版 Office。
Updates Enabled="TRUE"	Office 检查更新。
汇报 UpdatePath=“\\Server\Share”	Office 会在网络上的“\server\share”检查更新。
Display Level="None" AcceptEULA="TRUE"	当安装 Office 时，不显示用户界面。

Add 元素

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

示例

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     Version="16.0.15330.20306" >
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
  </Product>
  <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>  

SourcePath 属性（属于 Add 元素）

可选。

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

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

示例值：

• SourcePath=“\\server\share”
• SourcePath=“C：\Downloads\Microsoft”

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

Version 属性（属于 Add 元素）

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

在使用版本属性时，建议同时包含频道属性。 如果不包括 Channel 属性，则使用默认频道，该频道可能与指定版本不匹配。

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

示例值：

• 版本=“16.0.15330.20306”
• version=“MatchInstalled”

OfficeClientEdition 属性（属于 Add 元素）

可选。

定义是下载还是安装 32 位还是 64 位版本的 Microsoft 365 应用版。 如果设备上未安装 Microsoft 365 应用版且未设置 OfficeClientEdition，则 ODT 将自动选择 64 位版本。 但是，如果设备使用 32 位版本的 Windows 或 RAM 小于 4 GB，它会选择 32 位版本。 如果安装了 Microsoft 365 应用版但未指定 OfficeClientEdition，则 ODT 将与 Microsoft 365 应用版现有安装的体系结构相匹配。 如果安装了 Microsoft 365 应用版并指定了 OfficeClientEdition，则它必须与已安装的体系结构匹配。 如果不匹配，则安装失败，因为不支持混合体系结构。

允许值：

• OfficeClientEdition="64"
• OfficeClientEdition="32"

注意

基于 ARM 的设备需要 Windows 11 或更高版本才能运行 Microsoft 365 应用版。 这些设备不支持 32 位版本的 Microsoft 365 应用版。 在基于 Arm 的设备上安装 64 位版本时，它会自动包含经过 Arm 优化的组件，从而提高性能并确保与 Arm 架构兼容。

Channel 属性（属于 Add 元素）

可选。

定义要用于安装 Microsoft 365 应用版的通道。 如果设备上未安装 Microsoft 365 应用版，则“频道”属性的默认设置为“当前”。 如果设备上安装了 Microsoft 365 应用版，但未指定通道属性，则 ODT 将与现有安装的通道匹配。

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

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

允许的值：

• Channel=“BetaChannel”
• Channel=“CurrentPreview”
• channel=“current”
• channel=“MonthlyEnterprise”
• Channel=“SemiAnnualPreview”
• Channel=“SemiAnnual”

注意

• 每个更新通道以前允许的值仍然可用，这意味着您不必更新旧的配置文件 XML 文件。
• Beta 版频道 (有时称为预览体验成员 - 快) 不受 支持的内部 版本，因此应仅在测试环境中使用，并仅应由一小组选定用户（例如 IT 人员或应用程序开发人员）使用。

如果要部署Microsoft LTSC (Professional Plus 2024 或 Office LTSC 标准版 2024) Office 长期服务渠道（批量许可版本），则需要使用不同的更新渠道：PerpetualVL2024。 有关详细信息，请参阅 Office LTSC 2024 的更新频道。

如果要部署Microsoft LTSC) (Professional Plus 2021 或 Office LTSC 标准版 2021 的 Office 长期服务渠道（批量许可版本），则需要使用不同的更新渠道：PerpetualVL2021。 有关详细信息，请参阅 Office LTSC 2021 更新频道。

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

DownloadPath 属性（属于 Add 元素）

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

注意

在下载模式下运行 ODT 时需要网络连接，即使下载将来自使用 DownloadPath 指定的位置。

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

示例值：

• DownloadPath=“\\servera\share”

示例

<Configuration> 
  <Add SourcePath="\\serverb\share" OfficeClientEdition="64" Version="16.0.6741.2056" DownloadPath="\\servera\share"> 
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />      
    </Product> 
  </Add> 
</Configuration>

AllowCdnFallback 属性（属于 Add 元素）

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

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

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

允许值：

• AllowCdnFallback="True"
• AllowCdnFallback="False"

示例

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>  

MigrateArch 属性 (“添加元素”) 的一部分

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

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

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

OfficeMgmtCOM 属性 (“添加元素”的一部分)

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

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

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

允许的值：

• OfficeMgmtCOM=“True”
• OfficeMgmtCOM=“False”

示例

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" OfficeMgmtCOM="True" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>  
  <Updates Enabled="True"  /> 
</Configuration>

Product 元素

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

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

示例

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>
<Product ID="VisioProRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>

ID 属性（属于 Product 元素）

必填。

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

示例值：

• ID="O365ProPlusRetail"
• ID="VisioProRetail"
• ID="ProjectProRetail"

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

MSICondition 属性 (Product 元素的一部分)

可选。

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

可以指定由 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。WW 文件夹，其中包含现有 Office 产品版本的安装文件。 例如，Visio 专业版 2016 的 Setup.xml 文件位于 VisPro.WW 文件夹中。 可以指定多种类型的 Office 产品，用逗号分隔。 例如，可以指定“PrjStd，PrjStdR，PrjPro，PrjProR”来查找批量许可或零售版的 Project Standard 或 Project Professional 安装。

注意

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

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

MSICondition 属性示例

在下面的示例中，仅当设备上已安装基于 MSI 的 Project Standard 版本时，才会在设备上安装 Project。 此外，作为 Project Standard 安装的一部分，将从设备中删除。

<Configuration>
  <Add>
      <Product ID="ProjectProRetail" MSICondition="PrjStd,PrjStdR">
         <Language ID="en-us" />
         <Language ID="MatchPreviousMSI" />
      </Product>
  </Add>
  <RemoveMSI />
</Configuration>

Language 元素

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

示例

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
     <Language ID="MatchInstalled" />
     <Language ID="MatchOS" Fallback="en-us" />
  </Product>
</Add>  

ID 属性（属于 Language 元素）

必填。

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

示例值

• ID="en-us"
• ID="ja-jp"
• ID="MatchOS"
• ID="MatchPreviousMSI"
• ID=“MatchInstalled”

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

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

• 有关 Microsoft 365 应用版支持的语言列表，请参阅语言、区域性代码和配套校对语言。
• 有关 Visio 支持的语言列表，请参阅 Visio 桌面应用中支持的显示语言。
• Project 支持的语言与 Visio 相同。

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

如果 Microsoft 365 应用版不支持操作系统语言，或者 ODT 在本地源文件中找不到正确的语言包，则 MatchOS 和 MatchInstalled 无法安装操作系统语言。 为了帮助解决此问题，建议指定备份语言，并允许 ODT 将 CDN 用于丢失的文件。 为此，请使用回退属性和 AllowCdnFallBack 属性。

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

Fallback 属性（属于 Language 元素）

可选。

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

示例值：

• Fallback="en-us"
• Fallback="ja-jp"

TargetProduct 属性 (语言元素的一部分)

可选。

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

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

示例值：

<Language ID="MatchInstalled" TargetProduct="O365ProPlusRetail" />
<Language ID="MatchInstalled" TargetProduct="All" />

Display 元素

定义安装 Microsoft 365 应用版时用户看到的内容。

示例

<Display Level="None" AcceptEULA="TRUE" />  

Level 属性（属于 Display 元素）

可选。 如果未指定，则默认设置为 “完整” 。

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

如果级别设置为“完整”，则安装 Microsoft 365 应用版将提供正常的安装体验。

允许值：

• Level="None"
• Level="Full"

AcceptEULA 属性（属于 Display 元素）

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

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

允许值：

• AcceptEULA="TRUE"
• AcceptEULA="FALSE"

ExcludeApp 元素

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

示例

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise">
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
    <ExcludeApp ID="Publisher" />
  </Product>
</Add>  

如果使用包含 ExcludeApp 的配置文件在已安装 Microsoft 365 应用版的设备上安装 Office，则基于语言列表以不同的方式对 ExcludeApp 设置进行区别对待：

• 如果配置文件列出了设备上已安装的所有语言，则其 ExcludeApp 设置将覆盖任何以前的 ExcludeApp 设置。 即使文件的语言列表同时包含已安装的语言和其他语言，这同样适用。
• 如果配置文件中的语言列表不包含所有已安装的语言，则配置文件中的 ExcludeApp 设置将与设备上的 ExcludeApp 设置结合使用。

ID 属性（属于 ExcludeApp 元素）

必填。

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

允许值：

• ID="Access"
• ID="Excel"
• ID="Groove"
• ID="Lync"
• ID="OneDrive"
• ID="OneNote"
• ID="Outlook"
• ID=“OutlookForWindows”
• ID="PowerPoint"
• ID="Publisher"
• ID=“Teams”
• ID="Word"

注意

• 对于 OneDrive，请使用 Groove。 对于 Skype for Business，请使用 Lync 。
• OutlookForWindows 是指新的 Outlook 应用。 有关详细信息，请参阅 新 Outlook for Windows 概述
• 有关 Microsoft Teams 的详细信息，请参阅使用 Microsoft 365 应用版部署 Microsoft Teams。

Property 元素

定义某些 Microsoft 365 应用版行为和属性。

示例

<Property Name="FORCEAPPSHUTDOWN" Value="FALSE"/>
<Property Name="SharedComputerLicensing" Value="1"/>
<Property Name="SCLCacheOverride" Value="1" />
<Property Name="DeviceBasedLicensing" Value="1" />
<Property Name="SCLCacheOverrideDirectory" Value="\\server\share\%username%" />
<Property Name="PinIconsToTaskbar" Value="TRUE"/>
<Property Name="TenantAssociationKey" Value="TAK" />

Name 属性（属于 Property 元素）

必填。

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

Value 属性（属于 Property 元素）

定义命名属性的值。

AUTOACTIVATE 属性（属于 Property 元素）

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

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

允许的值：

• 属性名称=“AUTOACTIVATE” Value=“0”
• 属性名称=“AUTOACTIVATE” Value=“1”

FORCEAPPSHUTDOWN 属性（属于 Property 元素）

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

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

允许的值：

• 属性名称=“FORCEAPPSHUTDOWN” Value=“FALSE”
• 属性名称=“FORCEAPPSHUTDOWN” Value=“TRUE”

PACKAGEGUID 属性（属于 Property 元素）

可选。

默认情况下，ODT 创建的 App-V 包共享相同的 App-V 包 ID。 管理员可以使用 PACKAGEGUID 指定其他包 ID 。 它允许你将多个 Microsoft 365 应用版的 App-V 包发布到 App-V 管理服务器。 但是，它无法使你将多个 Microsoft 365 应用版 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。

示例值：

• 属性名称=“PACKAGEGUID” Value=“12345678-ABCD-1234-ABCD-1234567890AB”

SharedComputerLicensing 属性（属于 Property 元素）

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

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

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

允许值：

• Property Name="SharedComputerLicensing" Value="0"
• Property Name="SharedComputerLicensing" Value="1"

SCLCacheOverride 属性（属于 Property 元素）

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

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

允许值：

• Property Name="SCLCacheOverride" Value="0"
• Property Name="SCLCacheOverride" Value="1"

SCLCacheOverrideDirectory 属性（属于 Property 元素）

可选。

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

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

示例值：

• 属性名称=“SCLCacheOverrideDirectory” Value=“%appdata%\Microsoft”
• Property Name=“SCLCacheOverrideDirectory” Value=“\\server\share\%username%”

DeviceBasedLicensing 属性 (Property 元素的一部分)

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

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

允许的值：

• 属性名称=“DeviceBasedLicensing” Value=“1”
• 属性名称=“DeviceBasedLicensing” Value=“0”

PinIconsToTaskBar 属性（属于 Property 元素）

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

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

允许的值：

• Property Name=“PinIconsToTaskbar” Value=“FALSE”
• 属性名称=“PinIconsToTaskbar” Value=“TRUE”

注意

• Windows 7 不再支持 Microsoft 365 应用版。 有关更多详细信息，请参阅 Windows 7 终端支持和 Microsoft 365 应用版。
• Windows 8.1 不再支持 Microsoft 365 应用版。 有关详细信息，请参阅 Windows 8.1 终止支持和 Microsoft 365 应用版。

TenantAssociationKey 属性 (Property 元素的一部分)

注意

在 16.0.19929.20062 或更高版本的“Office 部署工具”中可用。

可选。

定义用于将设备与 Microsoft 365 应用版管理中心清单中的组织关联的租户特定密钥。 租户关联密钥是一个字母数字值，长度通常超过 300 个字符，可以通过登录并从左侧导航栏中选择“安装”，在 Microsoft 365 应用版管理中心找到该值。 在 XML 中包含此值时，Office 部署工具会自动向清单注册连接的设备。

示例值：

• 属性名称=“TenantAssociationKey” Value=“ReplaceWithTAK”

示例

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="MatchOS" />
    </Product>
  </Add>  
  <Property Name="TenantAssociationKey" Value="ReplaceWithTAK" />
</Configuration>

示例

<Configuration>
  <Property Name="TenantAssociationKey" Value="ReplaceWithTAK" />
</Configuration>

Remove 元素

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

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

示例

<Remove All="FALSE">
  <Product ID="O365ProPlusRetail" >
    <Language ID="es-es" />
  </Product>
</Remove>

All 属性（属于 Remove 元素）

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

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

允许值：

• All="FALSE"
• All="TRUE"

Updates 元素

定义 Microsoft 365 应用版在安装后如何更新。

示例

<Updates Enabled="TRUE" 
         UpdatePath="\\Server\Share\"
         Channel="SemiAnnual" />

Enabled 属性（属于 Updates 元素）

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

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

允许值：

• Enabled="TRUE"
• Enabled="FALSE"

UpdatePath 属性（属于 Updates 元素）

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

定义 Microsoft 365 应用版更新的来源。 UpdatePath 可以指定安装文件源的网络、本地或 HTTP 路径。 可将环境变量用于网络或本地路径。

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

示例值：

• UpdatePath=“\\server\share”
• UpdatePath="C:\Preload\Office"
• UpdatePath="http://internalApps/Office/"

TargetVersion 属性（属于 Updates 元素）

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

定义 Microsoft 365 应用版更新到的版本。 如果 TargetVersion 设置为特定内部版本号，则 Microsoft 365 应用版将尝试更新到该版本。

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

示例值：

• TargetVersion=“16.0.12345.12345”
• TargetVersion=""

Deadline 属性（属于 Updates 元素）

可选。

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

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

关闭 Microsoft 365 应用版后，将自动应用更新。 截止时间仅适用于一组更新。 如果要使用截止时间来确保 Microsoft 365 应用版始终是最新的，则必须在每次有新更新可用时更改截止时间。

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

示例值：

• Deadline="05/16/2014 18:30"

Channel 属性（属于 Updates 元素）

可选。 默认值为 “当前”。

定义安装后用于更新 Microsoft 365 应用版的频道。 有两个频道属性：“添加”元素的通道用于在安装 Microsoft 365 应用版时指定更新通道，汇报元素的通道用于更改 Microsoft 365 应用版现有安装的通道。

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

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

允许的值：

• Channel=“BetaChannel”
• Channel=“CurrentPreview”
• channel=“current”
• channel=“MonthlyEnterprise”
• Channel=“SemiAnnualPreview”
• Channel=“SemiAnnual”

注意

• 若要使用这些属性值，你需要至少使用 2020 年 6 月 9 日（星期二）发布的 Office 部署工具版本 16.0.12827.20268。
• 每个更新通道以前允许的值仍然可用，这意味着您不必更新旧的配置文件 XML 文件。
• Beta 版频道 (有时称为预览体验成员 - 快) 不受 支持的内部 版本，因此应仅在测试环境中使用，并仅应由一小组选定用户（例如 IT 人员或应用程序开发人员）使用。

如果部署批量许可版本的 Office LTSC 专业增强版 2024 或 Office LTSC 标准版 2024，则必须使用此更新通道：PerpetualVL2024。 有关详细信息，请参阅 Office LTSC 2024 的更新频道。

如果部署批量许可版本 Office LTSC 专业增强版 2021 或 Office LTSC 标准版 2021，则必须使用此更新渠道：PerpetualVL2021。 有关详细信息，请参阅 Office LTSC 2021 更新频道。

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

RemoveMSI 元素

可选。

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

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

IgnoreProduct 属性（属于 RemoveMSI 元素）

可选。

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

示例值：

• IgnoreProduct ID="VisPro"
• IgnoreProduct ID="PrjPro"

AppSettings 元素

可选。

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

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

示例

  <AppSettings>
    <User Key="software\microsoft\office\16.0\excel\security"
          Name="vbawarnings" 
          Value="3" 
          Type="REG_DWORD" 
          App="excel16" 
          Id="L_VBAWarningsPolicy" />
  </AppSettings>

相关文章

• Office 部署工具概述
• Microsoft 365 应用版部署指南
• 语言、区域性代码和伴随校对语言