导出 (0) 打印
全部展开

即点即用 configuration.xml 文件的参考

 

适用于: Office 365 ProPlus

上一次修改主题: 2014-12-15

摘要:提供有关 Office 365 即点即用产品的 Configuration.xml 文件的信息。

目标用户:IT 专业人员

Office 365 即点即用 Configuration.xml 文件用于指定即点即用安装和更新选项。Office 部署工具是一个包含示例 Configuration.xml 文件的可下载工具。管理员可以修改 Configuration.xml 文件,以便为 Office 365 即点即用 产品配置安装选项。

即点即用 Configuration.xml 文件是 Office 部署工具的必要组件。即点即用自定义设置主要是通过启动 Office 部署工具并提供自定义 Configuration.xml 文件来执行的。Office 部署工具执行通过使用配置文件中的可选属性而指定的任务。对于产品的 Office 2013 版本,管理员可以从 Microsoft 下载中心下载 Office 部署工具。

可以使用即点即用 Configuration.xml 文件执行以下任务:

  • 在安装中添加或删除产品

  • 在安装中添加或删除语言

  • 指定显示选项

  • 设置日志记录选项

  • 指定即点即用的软件更新行为

Important重要说明:
本文是面向 IT 专业人员的 部署 Office 365 ProPlus 的入门指南的一部分。可以使用该指南作为起点来获取可帮助您在组织中部署 Office 365 ProPlus 的文章。
您是否要查找有关使用 Office 365 安装 Office 的帮助信息?您可以查找 Office 365 入门使用 Office 365 安装 Office,它们将帮助您了解如何在计算机、电话和平板电脑上安装和使用 Office 365。

本文内容:

Note注意:
您无法自定义 Office 365 即点即用产品的安装位置。即点即用只能部署到系统驱动器(通常为驱动器 C)。

有关即点即用的已知问题的最新信息,请参阅 office.com 网站上的 Office 已知问题

下表列出了即点即用 Configuration.xml 元素。

Configuration.xml 参考

元素 说明

Configuration 元素

顶级元素

Add 元素

指定要安装的产品和语言

Display 元素

安装程序向用户显示的 UI 级别

ExcludeApp 元素

Product 子元素。指定不安装哪些 Office 程序

Language 元素

Product 子元素。向安装添加语言

Logging 元素

指定安装程序执行的日志记录类别的选项

Product 元素

AddRemove 子元素。指定要安装的产品

Property 元素

用于一般属性。

Remove 元素

指定要删除的产品和语言

Updates 元素

指定 Office 检查和获取产品更新的方式

即点即用 Configuration.xml 中的 XML 元素以 < 开头,以 /> 结尾。

以下是基本元素格式:

< 元素 [属性=""] [属性=""] … />

在安装产品并代表用户接受许可条款后,以下示例将不会显示用户界面:

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

下表列出了本参考中使用的约定。

格式惯例

格式 说明

粗体

元素名称或属性名称

常规

按照所示输入文本

斜体

某个值的占位符

X | Y

在两个值之间选择

{x}

可选值

顶级元素。此元素是必需的,并且所有其他元素都必须出现在此元素中。

<Configuration>

{0 或 1 个 Add 元素}

{0 或 1 个 Remove 元素}

{0 或 1 个 Updates 元素}

{0 或 1 个 Display 元素}

{0 或 1 个 Logging 元素}

</Configuration>

指定要安装的产品和语言。

<Add

 SourcePath="\\server\share\"

 Version="15.1.2.3"

OfficeClientEdition=32 | 64

>

{0 或 N 个 Product 元素}

</Add>

下表介绍了 Add 元素的属性和值。

Add 元素属性和值

属性 说明

SourcePath

\\server\share\

C:\Preload\Office

http://internalApps/Office/

可选。

SourcePath 值可设置为包含即点即用源的网络、本地或 HTTP 路径。环境变量可用于网络或本地路径。

SourcePath 表示当您在 download 模式下运行 即点即用时用于保存Office 部署工具安装源的位置。

SourcePath 指示在 configure 模式下运行 Office 时,从中安装 Office 部署工具 的安装源路径。如果您没有在 configure 模式下指定 SourcePath。安装程序将在当前文件夹中查找 Office 源文件。如果在当前文件夹中未找到 Office 源文件,安装程序将在 Office 365 上进行查找。

SourcePath 指定当您在 packager 模式下运行 即点即用时从中生成 App-V 包的 Office Office 部署工具 源的路径。

如果未指定 SourcePath,安装程序将尝试在运行 setup.exe 的工作目录中创建 \Office\Data\... 文件夹结构。

Version

15.1.2.3

可选。如果未设置 Version 值,则即点即用产品安装将从源中流式传输最新可用版本。默认设置是使用最新发布版本(如即点即用 Office 安装源中 v32.CAB 或 v64.CAB 的定义)。

Version 可设置为 Office 2013 内部版本号,格式为:X.X.X.X

OfficeClientEdition

3264

必需。指定要使用的 即点即用 Office 365产品的版本:32 位或 64 位。如果 OfficeClientEdition 未设置为有效值,则操作将失败。

如果 OfficeClientEdition 设置不正确,则 configure 模式操作可能会失败。例如,尝试在运行 32 位 Windows 操作系统的计算机上安装 64 位版本的 即点即用 Office 365产品,或尝试在安装了 64 位版本 即点即用 的计算机上安装 32 位的 Office 365 Office产品。

不再支持 ForceDowngrade 属性。

Note注意:
Product 元素指定要安装的产品,还指定语言(由 {1 或 N 个 Language 元素} 指示)。请参阅 Language 元素

以下示例中的代码将从指定的 \\server\share 网络共享位置安装 Office 365 ProPlus 32 位的英语(美国)15.1.2.3 版本。

<Add SourcePath="\\server\share\" Version="15.1.2.3" OfficeClientEdition="32"> 
      <Product ID="O365ProPlusRetail">
        <Language ID="en-us" />
      </Product>
</Add>

指定向用户显示的用户界面级别。

<Display

 Level=None | Full

 AcceptEULA=TRUE | FALSE

/>

下表描述 Display 元素属性和值。

Display 元素属性和值

属性 说明

Level

None

Full

可选。确定用户在执行操作时可看到的用户界面。

如果 Level 设置为 None,则用户看不到 UI。不会显示进度 UI、完成屏幕、错误对话框或首次运行自动启动 UI。

如果 Level 设置为 Full,则用户将看到正常的即点即用用户界面:自动启动、应用程序初始屏幕和错误对话框。

AcceptEULA

TRUE

FALSE

可选。建议管理员将 AcceptEULA 设置为 TRUE

如果将此属性设置为 TRUE,则用户不会看到“Microsoft 软件许可条款”对话框。

如果将此属性设置为 FALSE 或不设置,则用户可能会看到“Microsoft 软件许可条款”对话框。

此属性仅适用于您使用用户帐户进行安装的情况。如果您使用 System Center Configuration Manager 或某些其他使用 SYSTEM 帐户进行安装的软件分发工具,则此属性的设置并不适用。

    示例:

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

指定不安装哪些 Office 程序。

<ExcludeApp ID= "Access" />

下表描述 ExcludeApp 元素的属性和值。

ExcludeApp 元素的属性和值

属性 说明

ID

Access

可选。

以下是受支持的 ID 值的列表:

  • Access

  • Excel

  • Groove

  • InfoPath

  • Lync

  • OneNote

  • Outlook

  • PowerPoint

  • Project

  • Publisher

  • SharePointDesigner

  • Visio

  • Word

“Groove”值用于排除 OneDrive for Business。

以下示例演示如何安装 32 位的 Office 365 ProPlus 英语版本(无 Access 或 InfoPath)。

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <ExcludeApp ID="Access" />
      <ExcludeApp ID="InfoPath" />
    </Product>
</Add>

使用 ExcludeApp 元素的最低要求如下:

  • Office 程序   至少是 2014 年 5 月发布的 15.0.4615.1001 版本。

  • Office 部署工具   至少是 2014 年 5 月发布的 15.0.4619.1000 版本。

有关使用 ExcludeApp 元素的详细信息,请参阅部署 Office 365 ProPlus 时排除某些 Office 程序

指定要安装的语言。

<Language ID= "ll-cc" />

下表介绍了 Language 元素的属性和值。

Language 元素属性和值

属性 说明

ID

ll-cc

必需。如果未设置 Language ID 值,则安装操作会失败并指示输入无效。

ID 值可设置为有效的 Office 区域性语言(如 en-us 表示美式英语,ja-jp 表示日语)。ll-cc 值是语言标识符。

有关语言 ID(语言标记)的详细信息,请参阅语言标识符

Note注意:
Language 元素确定要安装的产品语言。管理员必须指定要安装的语言。第一语言确定外壳 UI 区域性。外壳 UI 是快捷方式、右键单击上下文菜单和工具提示的语言。
如果初始安装后您决定要更改外壳 UI 语言,则必须卸载即点即用,然后再重新安装。将要为外壳 UI 设置的语言添加为自定义 Configuration.xml 文件中的第一种语言。

下面的示例说明如何安装 32 位英语、日语和西班牙语版的 Office 365 ProPlus。

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <Language ID="es-es" />
      <Language ID="ja-jp" />
    </Product>
</Add>

指定即点即用执行的日志记录类型。

<Logging

Level =Off | Standard

Path=UNC 或本地路径

/>

下表描述 Logging 元素属性和值。

Logging 元素属性和值

属性 说明

Level

Off

Standard

可选。指定即点即用安装程序执行的日志记录的选项。默认级别为 Standard

Path

%temp%\\server\share\userlogs\

可选。指定用于日志文件的文件夹的完全限定路径。可以使用环境变量。默认值为 %temp%

不再支持 Name 属性。

    示例:

<Logging Level="Standard" Path="%temp%" />

指定要安装的即点即用产品。

<Product

ID="O365ProPlusRetail"

PIDKEY="12345-12345-12345-12345-12345"

>

{1 或 N 个 Language 元素}

</Product>

下表介绍了 Product 元素的属性和值。

Product 元素属性和值

属性 说明

ID

O365ProPlusRetail

必需。ID 必须设置为有效的 ProductRelease ID。

即点即用 Office 365产品支持的 ProductRelease ID 如下所示:

  • O365ProPlusRetail

  • VisioProRetail

  • ProjectProRetail

  • SPDRetail (SharePoint Designer)

如果未设置 ID,则操作会失败并指示输入无效。

Product 元素的顺序确定产品安装顺序。第一个 Product ID 用于确定 Microsoft Office 首次运行体验应用程序启动的上下文。Microsoft Office 首次运行体验指的是每个 Office 应用程序第一次启动。

Note注意:
有关受支持的非 Office 365 产品 ID 的列表,请参阅 Microsoft 知识库文章即点即用 Office 部署工具支持的产品 ID

PIDKEY

12345-12345-12345-12345-12345

可选。如果设置 PIDKEY,指定的 25 个字符的 PIDKEY 值将用于本产品。

以下示例指定 Office 365 ProPlus。

<Product ID="O365ProPlusRetail" />

以下示例将 Office 365 ProPlus 和 Visio Pro for Office 365 指定为英语(美国)、西班牙语和日语。

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
  <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <Language ID="es-es" />
      <Language ID="ja-jp" />
  </Product>
  <Product ID="VisioProRetail" >
      <Language ID="en-us" />
      <Language ID="es-es" />
      <Language ID="ja-jp" />
  </Product>
</Add>

支持如下所述的常规属性。

<Property Name=string Value=string />

其中:

  • Name 是必需的属性。它指示 Property 的名称。

  • Value 是可选属性。默认值为空字符串。

下表描述 Property 元素属性和值。

Property 元素属性和值

属性 说明

AUTOACTIVATE

1

0

如果 AUTOACTIVATE 设置为 1,则指定的产品将尝试自动激活。如果未设置 AUTOACTIVATE,则用户可以查看激活向导 UI。

Note注意:
Office 365 即点即用产品已设置为自动激活。您不能为 即点即用 Office 365产品设置 AUTOACTIVATE
此设置仅适用于即点即用产品的永久零售版。

FORCEAPPSHUTDOWN

TRUE

FALSE

如果 Office 应用程序正在运行,则会阻止安装或删除操作。通常,这种情况下会启动进程终止程序 UI。管理员可以将 FORCEAPPSHUTDOWN 值设置为 TRUE 以避免对用户交互的依赖。当 FORCEAPPSHUTDOWN 设置为 TRUE 时,阻止操作的所有应用程序都将关闭。可能会发生数据丢失现象。当 FORCEAPPSHUTDOWN 设置为 FALSE(默认值)时,如果 Office 应用程序正在运行,操作将失败。

PACKAGEGUID

12345678-ABCD-1234-ABCD-1234567890AB

可选。默认情况下,使用 Office 2013创建的所有 Office 部署工具 App-V 包共享同一个 App-V 包 ID。管理员可以使用 PACKAGEGUID 指定另一个包 ID。

这使您可以将多个 Office 2013 App-V 包发布到 App-V 管理服务器。但是,这并不能使您将多个 Office 2013 App-V 包部署到单个计算机上。

SharedComputerLicensing

1

0

可选。如果您使用远程桌面服务将 Office 365 ProPlus 部署到共享计算机,请将 SharedComputerLicensing 设置为 1。

有关详细信息,请参阅Office 365 ProPlus 共享计算机激活概述

示例

<Property Name="AUTOACTIVATE" Value="1" />

删除产品和语言。

<Remove

All=TRUE | FALSE

>

{0 或 N 个 Product 元素}

</Remove>

下表介绍了 Remove 元素的属性和值。

Remove 元素属性和值

属性 说明

All

TRUE

FALSE

可选。默认值为 FALSE。如果 All 设置为 TRUE,则将删除所有即点即用产品。

Important重要说明:
如果指定 Product 元素且它们包括 Language 元素 ID,则安装程序会删除该产品的语言资源。除非执行此操作将删除该产品的全部语言资源,或者即点即用 Configuration.xml 文件中包含的 Add 元素中也指定了产品和语言组合,否则将会出现此情况。
如果指定 Product 元素且它们不包括 Language 元素,则安装程序会删除该产品和任何关联的语言资源。除非在即点即用 Configuration.xml 文件的 Add 元素中也可找到相同的 Product,否则将会出现此情况。
如果 All 设置为 TRUE,则安装程序会删除整个安装,无论在 Add 元素中指定了什么。

以下示例中的代码将删除 Office 365 ProPlus。

<Remove>
    <Product ID="O365ProPlusRetail" />
</Remove>

以下示例中的代码将从 Office 365 ProPlus 安装中删除西班牙语资源。

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

以下示例中的代码将删除整个安装。

<Remove All="TRUE" />

指定用于配置更新的属性。

<Updates

Enabled=TRUE | FALSE

UpdatePath=UNC | 本地 | http 路径

TargetVersion=X.Y.Z.W

Deadline=MM/DD/YYYY HH:MM

/>

下表介绍了 Updates 元素的属性和值。

Updates 元素属性和值

属性 说明

Enabled

TRUE

FALSE

可选。如果 Enabled 设置为 TRUE,则即点即用更新系统将检查更新。如果设置为 FALSE,则即点即用更新系统将处于休眠状态。

UpdatePath

\\server\share\

C:\Preload\Office

http://internalApps/Office/

""

可选。如果未设置 UpdatePath,则即点即用安装会从 Microsoft 即点即用源(内容交付网络或 CDN)获取更新。这是默认设置。

如果 UpdatePath 设置为空 (""),则会从 Microsoft 即点即用源(即 CDN)获取更新。

UpdatePath 可以指定即点即用源的网络、本地或 HTTP 路径。

环境变量可用于网络或本地路径。

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

TargetVersion

15.1.2.3

""

可选。如果未设置 TargetVersion,则即点即用将更新到 Microsoft 即点即用源中的最新版本。

如果 TargetVersion 设置为空 (""),则即点即用将更新到 Microsoft 即点即用源中的最新版本。

TargetVersion 可设置为 Office 内部版本号,例如,15.1.2.3。设置版本后,Office 会在下一个更新周期中尝试切换到指定版本。

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

Deadline

2014 年 5 月 16 日 18:30

可选。设置了更新到 Office 必须应用的截止时间。截止时间在协调世界时 (UTC) 中指定。

可以使用 DeadlineTarget Version 确保将 Office 更新到特定日期的特定版本。建议您将截止日期至少设置为一周后,以便为用户留出安装更新的时间。

用户将在截止日期之前收到多个安装更新的提醒。如果 Office 未在截止日期之前安装,用户将看到一个通知,指示更新将在 15 分钟后应用。这就使用户可以保存正在进行的 Office 文档,并关闭所有打开的 Office 程序。如果用户不关闭 Office 程序,则程序会在 15 分钟后自动关闭,这可能会导致数据丢失。关闭 Office 程序后,将自动应用更新。

截止日期仅适用于一组更新。如果您要使用截止日期确保 Office 始终为最新版本,必须在每次 Office 的更新可用时更改截止日期。

若要使用此属性,Office 必须至少运行 Service Pack 1(版本 15.0.4569.1507),且您必须至少使用 Office 部署工具 的版本 15.0.4595.1000。

如果您使用组策略和 Office 2013 管理模板文件 (ADMX/ADML),则可以使用“更新截止时间”策略设置来设置 Deadline。您可以在 Computer Configuration\Administrative Templates\Microsoft Office 2013 (Machine)\Updates 下找到此策略设置。

以下示例启用 Office 更新,使用替代更新路径,产品版本设置为 15.1.2.3,且截止时间设置为 2014 年 5 月 16 日 晚上 6:30 (UTC)。

<Updates Enabled="TRUE" UpdatePath="\\Server\share\" TargetVersion="15.1.2.3" Deadline="05/16/2014 18:30"/>

以下示例禁用更新。

<Updates Enabled="FALSE" />

以下即点即用 Configuration.xml 文件示例中的代码指定安装 32 位英语(美国)版 Office 365 ProPlus 和 Visio Pro for Office 365。它将更新设置为 Enabled,并使用替代源。它还将 Display Level 设置为 None,并接受最终用户许可协议。

<Configuration>
  <Add SourcePath="\\Server\Share" OfficeClientEdition="32" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
    <Product ID="VisioProRetail">
      <Language ID="en-us" />
    </Product>
  </Add>  
  <Updates Enabled="TRUE" UpdatePath="\\Server\Share" /> 
  <Display Level="None" AcceptEULA="TRUE" />  
  <Logging Level="Standard" Path="%temp%" /> 
</Configuration>

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2015 Microsoft