Office 部署工具的配置选项

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

注意

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

标准配置文件示例

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

创建配置文件时，建议从示例文件开始，并使用适合你的环境的恰当选项更新该文件。 首先，可以将以下示例复制并粘贴到文本文件中，并使用所选名称保存它。 使用 文件修改 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”，并使用该位置的安装文件进行部署。
添加 OfficeClientEdition=“64”	下载并安装 64 位版本的 Office
Add 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 元素）

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

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

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

示例值：

• 版本=“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 应用版，则 Channel 属性的默认设置为 Current。 如果在设备上安装了Microsoft 365 应用版，但未指定通道属性，则 ODT 与现有安装的通道匹配。

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

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

允许的值：

• Channel=“BetaChannel”
• Channel=“CurrentPreview”
• Channel=“Current”
• Channel=“MonthlyEnterprise”
• Channel=“SemiAnnualPreview”
• Channel=“SemiAnnual”

注意

• 仍可使用每个更新通道的以前允许值，这意味着无需更新旧的配置 XML 文件。
• Beta 频道 (有时称为预览体验成员快速) 不受 支持，因此只能用于测试环境和一小群选定用户（例如 IT 员工或应用程序开发人员）。

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

如果要部署 Office 专业增强版 2019 或 Office Standard 2019（即批量许可版本），则需要使用其他更新通道：永久VL2019。 有关详细信息，请参阅 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 属性 (Add 元素) 的一部分

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

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

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

OfficeMgmtCOM 属性 (Add 元素) 的一部分

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

如果设置为 True，则会注册 COM 对象，这是允许更新管理解决方案 (Microsoft Configuration Manager) 管理更新所必需的。 使用 Configuration Manager 进行Microsoft 365 应用版更新时是必需的。 启用 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 版本，则安装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 结合使用以简化升级。

MSICondition 属性的示例

在以下示例中，仅当设备上已安装基于 MSI 的 Project Standard 版本时，才会在设备上安装Project Online桌面客户端。 此外，Project Online桌面客户端安装过程中，将从设备中删除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 应用版 时删除 Office 的现有 MSI 版本。

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

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

Fallback 属性（属于 Language 元素）

可选。

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

示例值：

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

TargetProduct 属性 (Language 元素) 的一部分

可选。

使用 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 元素）

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

如果“级别”设置为“无”，则安装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=“必应”
• 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。
• “必应”是指在必应中Microsoft搜索的后台服务。 有关详细信息，请参阅Microsoft 必应搜索和 Microsoft 365 企业应用版。

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

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 。

如果使用远程桌面服务将 sharedComputerLicensing 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”
• 属性名称=“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 Configuration Manager 部署时很常见）安装Microsoft 365 应用版，则即使此属性设置为 True，也不会固定图标。

允许的值：

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

注意

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

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 路径。 可将环境变量用于网络或本地路径。

如果将 组策略 用于 Office 的管理模板文件 (ADMX/ADML) ，则可以使用更新路径策略设置来设置 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 应用版尝试更新到该版本。

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

示例值：

• TargetVersion=“16.0.12345.12345”
• TargetVersion=""

Deadline 属性（属于 Updates 元素）

可选。

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

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

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

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

示例值：

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

Channel 属性（属于 Updates 元素）

可选。 默认值为 Current。

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

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

如果将 组策略 用于 Office 的管理模板文件 (ADMX/ADML) ，则可以使用更新通道策略设置来设置通道。 您可以在“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 专业增强版 2021或Office LTSC 标准版 2021（即批量许可版本），则必须使用此更新通道：永久VL2021。 有关详细信息，请参阅 Office LTSC 2021 更新频道。

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

RemoveMSI 元素

可选。

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

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

IgnoreProduct 属性（属于 RemoveMSI 元素）

可选。

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

示例值：

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

AppSettings 元素

可选。

定义Microsoft 365 应用版的应用程序首选项，包括 VBA 宏通知、默认文件位置和默认文件格式。 若要创建具有应用程序首选项的配置文件，建议使用 即点即用 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 应用版部署指南
• 语言、区域性代码和伴随校对语言