2007 Office system 中的 Config.xml 文件

更新时间: 2010年9月

应用到: Office Resource Kit

 

上一次修改主题: 2015-03-09

如果您是 IT 专业人员并使用 TechNet 或 Office 资源工具包,请看一下我们的在线调查(该链接可能指向英文页面) (https://go.microsoft.com/fwlink/?linkid=132189\&clcid=0x804)(该链接可能指向英文页面)。请告诉我们如何才能最大限度地满足您对文档的需求。您可以在 Office 资源工具包博客(该链接可能指向英文页面) (https://go.microsoft.com/fwlink/?linkid=125627\&clcid=0x804)(该链接可能指向英文页面)上详细了解我们为改进文档所做的工作。

本文内容:

  • Config.xml 元素快速参考

  • 工作原理

  • Config.xml 文件格式

  • Config.xml 元素参考

  • 示例 Config.xml 文件

Office 自定义工具 (OCT) 是对 2007 Microsoft Office system 中的产品进行自定义安装的主要工具。有关如何使用 OCT 来创建安装程序自定义文件的详细信息,请参阅 2007 Office system 中的 Office 自定义工具

Config.xml 文件用于配置安装任务,并 在运行安装程序时使用;该文件 会安装或缓存在用户的计算机上。管理员可以编辑 Config.xml 文件进行自定义安装。默认情况下,Config.xml 文件存储在核心产品文件夹(core_product_folder_name.WW 文件夹,例如,Enterprise.WW 或 Pro.WW)中,该文件将指导安装程序安装该产品。例如,Pro.WW 文件夹中的 Config.xml 文件将安装 Microsoft Office Professional 2007。

您可以使用 Config.xml 文件,执行以下安装任务:

  • 指定网络安装点的路径。

  • 选择要安装的产品。

  • 自定义安装程序选项,如日志记录以及安装程序自定义文件和软件更新的位置。

  • 设置安装选项(如用户名和公司名)。

  • 将本地安装源 (LIS) 复制到用户的计算机,但不安装 Office。

  • 从安装中添加或删除语言。

Config.xml 文件还可以用于维护操作,例如添加或删除功能、修复和卸载。为此,管理员必须从原始的源中重新运行 Setup.exe。有关详细信息,请参阅“使用 Config.xml 文件进行维护”维护 2007 Office system 的最佳做法

自定义使用组策略软件安装进行部署的安装时,需要使用 Config.xml。有关详细信息,请参阅使用组策略软件安装来部署 2007 Office system

Important重要信息
使用文本编辑器(如记事本)来编辑 Config.xml。不要使用通用的 XML 编辑器,如 Microsoft Office Word 2007。

有关编辑 Config.xml 文件并查看自定义的 Config.xml 文件示例的信息,请参阅部署 2007 Office system 的自定义配置(分步说明)

Config.xml 元素快速参考

下表包含 Config.xml 中的元素列表。除了必须排在最前面的 Configuration 元素 元素以及某些在 Config.xml 中的顺序会影响其在安装过程中的处理方式的元素(如 Command 元素)外,这些元素可以按任何顺序显示。

元素 说明

Configuration 元素

顶层元素。

AddLanguage 元素

向安装添加语言

ARP 元素

控制产品在“控制面板”中的“添加或删除程序”的文本和行为的值

CCP_DRIVE 元素

通过 RMCCPSEARCH 搜索的文件夹的完全限定路径

Command 元素

在安装过程中运行命令

COMPANYNAME 元素

在其计算机上安装产品的用户的单位或公司名称

Display 元素

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

DistributionPoint 元素

要运行安装的网络安装点的完全限定路径

INSTALLLOCATION 元素

用户计算机上产品安装文件夹的完全限定路径

LIS 元素

本地安装源 (LIS) 如何缓存在用户计算机上的选项

Logging 元素

安装程序执行的日志记录类型的选项

MinOSRequirement 元素

此产品支持的最低配置的操作系统

OptionState 元素

指定在安装过程中如何处理单个产品功能的选项

PIDKEY 元素

由 25 个字符组成的批量许可证密钥

RemoveLanguage 元素

从安装中删除语言

Setting 元素

Windows Installer 属性的值

SetupUpdates 元素

用于查找安装程序自定义文件的安装程序的搜索路径

USERINITIALS 元素

产品安装所在计算机的用户名的首字母缩写

USERNAME 元素

在其计算机上安装产品的用户的名称

工作原理

安装程序在 Setup.exe 所在的同一文件夹中查找 Config.xml 副本。如果在其中没有找到该副本,安装程序则使用位于要安装的产品的核心产品文件夹中(如果网络安装点中有多个产品,安装程序将在您指定要安装的产品之后才开始查找 Config.xml 副本)的 Config.xml 文件。位于产品文件夹中的 Config.xml 副本通过 Configuration 元素 元素的 Product 属性来标识产品。

还可以使用 /config 安装程序命令行选项指定 Config.xml 文件的位置。例如:

\\ 服务器 \ 共享 \setup.exe /config \\ 服务器 \ 共享 \Enterprise.WW\config.xml

Note注意
如果您还使用 OCT 创建了安装程序自定义文件,在 Config.xml 中定义的自定义设置将优先于自定义文件中的设置。

Config.xml 文件格式

Config.xml 中的 XML 元素以 < 开头,以 /> 结尾。

基本元素格式是:

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

例如:

<Display Level="none" AcceptEula="Yes" />

元素和属性区分大小写。属性值必须用引号 (") 括起来并且不区分大小写。

元素定义可跨越多个行。元素定义中将忽略空格、回车符、换行符和制表符。

例如:

<Display
   Level="none"
   AcceptEula="yes"
/>
Tip提示
对于较长的元素定义,为使文件更容易阅读,应将属性置于单独的行中并使用缩进。

Configuration 元素 元素属于特例而且是必需的。所有其他元素都包含在 Configuration 元素 元素中,并且该元素以 </Configuration> 结尾。

例如:

<Configuration Product="Enterprise">
   <PIDKEY Value="1234512345123451234512345" />
   <Display Level="none" AcceptEula="Yes"/>
</Configuration>

可以在任意位置添加备注,并使用“<!--”和“-->”分隔备注。

例如:

<!-- Install Office Enterprise 2007 -->
<Configuration Product="Enterprise" >
   <!-- Set the product key -->
   <PIDKEY Value="1234512345123451234512345" />
   <Display
      <!-- Turn off all Setup UI -->
      Level="none"
      <!-- Accept the EULA for the user -->
      AcceptEula="Yes"
   />
</Configuration>

每个 Office 产品文件夹都包含默认的 Config.xml 文件,其中包括 Product 属性设置为产品的适当值的 Configuration 元素 元素。许多括在注释内的示例元素都包含在 Configuration 元素 元素中。删除开始和结束的注释标记,并输入适当的属性值以激活这些元素。

例如,激活 PIDKEY 元素 元素的方法是将下面的值:

<!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->

更改为:

<PIDKEY Value="1234567890123456789012345" />

Config.xml 元素参考

该参考的说明中使用下列约定:

bold

元素或属性名

普通

要完全按照所示方式输入的文本

斜体

要添加的值的占位符

x|y

在多个值之间进行选择

[x]

可选值

Configuration 元素

顶层元素。该元素是必需的,其他所有元素必须显示在该元素中。

语法

<Configuration [Product="productID"] >

   ...

</Configuration>

属性

属性 说明

Product

productID

安装的产品的 setup.xml 文件中 Setup 元素的 ID 属性值

注释

Product 属性会标识此 Config.xml 文件所影响的产品。productID 在 Setup.xml 文件(位于产品的核心文件夹中)中的 Setup 元素的 ID 属性中定义。

Product 属性是可选的,除非您将 Display 元素Level 属性设置为“Basic”或“None”。在本例中,Product 属性是必需的。如果由 Product 属性指定的产品在网络安装点中不存在,安装程序将会结束安装。

示例

Office Enterprise 2007 的 productID 位于 Enterprise.WW\Setup.xml 的以下行中:

<Setup Id="Enterprise" Type="Product" ... >

您使用 Config.xml 中的 productID 通过输入以下代码来指定 Office Enterprise 2007:

<Configuration Product="Enterprise">
   ...
</Configuration>

AddLanguage 元素

向安装添加指定语言。

语法

<AddLanguage

   Id="ll-cc" | "match"

   [ShellTransform="Yes"]

/>

属性

属性 说明

Id

ll - cc

语言标识符。有关语言标记的完整列表,请参阅 2007 Office system 中的语言标识符

match

与用户的 Windows 用户区域设置的语言相匹配。

ShellTransform

Yes

指定外壳用户界面的语言。如果指定了多个 AddLanguage 元素,则一个(只有一个)语言必须指定 ShellTransform 元素。

注释

该语言必须在网络安装点中提供。

您可以具有多个 AddLanguage 和 RemoveLanguage 元素 元素。如果 RemoveLanguage 元素 和 AddLanguage 两个元素指定了同一个语言,则 AddLanguage 元素将具有优先权并将安装该语言。

Note注意
如果指定了多个 AddLanguage 元素,则一个(只有一个)语言必须指定 ShellTransform 元素,否则安装程序将结束安装。

安装 2007 Office system 时您应了解三种不同的语言概念:

  • 安装程序用户界面 (UI):安装的语言。

  • 外壳 UI:快捷方式、右键单击上下文菜单和工具提示的语言。

  • Office UI:Office 用户界面和菜单的语言。

如果有多个 Office 语言,则这三个值按如下方式进行确定:

默认情况下,安装程序 UI 取决于安装的可用资源集以及与用户区域设置匹配的能力。安装程序 UI 将默认与用户区域设置相匹配。外壳 UI 取决于安装的语言集,默认情况下将遵循安装程序 UI 的设置。默认的 Office UI 语言取决于用户区域设置和当前的用户设置。默认值是使用每个用户计算机上的 Windows 用户区域设置。这意味着在默认情况下,安装程序 UI、外壳 UI 和 Office UI 都是相同的。

Windows 操作系统中的区域设置 是一组与用户的语言、环境和区域性约定相关的用户首选项信息。此信息以值的列表来表示,用于确定正确的输入语言、键盘布局、排序顺序以及数值、日期、货币和时间使用的格式。用户区域设置是每个用户的设置,可确定默认情况下用于显示日期、时间、货币、数值和文本排序顺序的格式。每个计算机上创建的帐户都将指定用户区域设置。

如果管理员在 Config.xml 文件中指定安装多种语言,则必须从安装语言集中选择外壳 UI 语言。为此,管理员需要在 Config.xml 文件中指定 AddLanguage 元素的 ShellTransform 属性。这将指定外壳 UI 应使用的语言安装程序。但是,在客户的计算机上安装时,这未必会影响安装程序 UI 或 Office UI 的选择。

例如,如果您有英语、法语、德语和西班牙语的 Office 映像,若要指定安装程序对所有这些语言都安装完全的语言支持,并使外壳 UI 遵循用户的默认区域选项,您可以在 Config.xml 文件中添加以下元素:

<AddLanguage Id="match" ShellTransform="yes"/> <AddLanguage Id="en-us" /> <AddLanguage Id="fr-fr" /> <AddLanguage Id="de-de" /> <AddLanguage Id="es-es" />

在上述示例中,安装程序会安装所有指定的语言并且外壳 UI 与用户的区域设置的语言相匹配。如果在源映像中包含多个语言,则上述示例中的 match 值可能会在 match 语言无法解析为其他四个明确标示的语言的情况下安装一个附加语言。例如,如果在源中还包含了日语,在用户区域设置为日语的计算机上执行安装时,此示例除了安装其他四个语言之外,还会安装日语。

示例

<AddLanguage Id="en-us" ShellTransform="Yes" />

ARP 元素

指定控制该产品在“控制面板”中的“添加或删除程序”的文本和行为的值。

语法

<ARP 属性 =" " [属性**=""**] ... />

属性

属性 说明

ARPCOMMENTS

文本

其他文本。最多可以包含 255 个字符,但并非所有字符都能显示。

ARPCONTACT

文本

技术支持联系人的列表。

ARPNOMODIFY

Yes

通过禁用“更改”按钮来防止用户修改产品安装。

No(默认值)

允许用户修改产品安装。

ARPNOREMOVE

Yes

通过禁用“删除”按钮来防止用户删除产品。

No(默认值)

允许用户删除产品。

ARPURLINFOABOUT

URL

产品主页的 URL。

ARPURLUPDATEINFO

URL

有关产品更新信息的 URL。

ARPHELPLINK

URL

用户可从中接收技术支持的网站的 URL。

ARPHELPTELEPHONE

文本

技术支持的电话号码。

CCP_DRIVE 元素

通过 RMCCPSEARCH 搜索的文件夹的完全限定路径。RMCCPSEARCH 操作使用文件签名在执行升级安装之前验证是否在系统中安装了合格的产品。

语法

<CCP_DRIVE Value=" " />

属性

属性 说明

Value

通过 RMCCPSEARCH 搜索的文件夹的完全限定路径

示例

<CCP_DRIVE Value="\\server\office2003" />

Command 元素

指定要运行的命令行。有关详细信息,请参阅注释部分。

Tip提示
OCT 中等效的选项是添加安装并运行程序

语法

<Command

   Path="path"

   [QuietArg="arguments"]

   [Args="args"]

   [ChainPosition="Before" | "After"(default)]

   [Wait="mseconds"]

   [Execute="Install"(default) | "Uninstall"]

   [Platform="x86"(default) | "x64"]

/>

属性

下表说明 Command 元素的属性。

属性 说明

Path

路径

可执行文件的完全限定路径。如果路径值包含空格,则必须使用双引号,如以下示例所示:

"\\server\share\Office 12\copylogs.bat"

QuietArg

字符串

配置无提示安装时追加到命令行的参数字符串。有关何时使用 QuietArg 属性的详细信息,请参阅此表下方的注释部分。

Args

字符串

要传递给可执行文件的参数字符串。有关何时使用 Args 属性进行链接安装的信息,请参阅此表下方的注释部分。

如果 Args 元素的值包含引号,您可以使用单引号 (') 将整个值括起来,如以下示例所示:

Args='"/param value"'

ChainPosition

Before

此命令在安装主产品之前执行。

After(默认值)

此命令在安装主产品之后执行。

Wait

毫秒

在将 Display 元素Level 属性设置为“full”或“basic”的情况下安装产品时,该值表示在运行程序之后、继续安装之前要等待的毫秒数。默认值为 0(零),表示无需等待。

Execute

Install(默认值)

安装程序在安装主产品时执行此命令。

Uninstall

安装程序在卸载主产品时执行此命令。

Platform

x86(默认值)

指定该程序需要 Intel x86 平台。仅当进行安装的计算机符合此平台要求时才运行此命令。

x64

指定该程序需要支持 x86 体系结构的 x64 扩展的 64 位处理器。仅当进行安装的计算机符合此平台要求时才运行此命令。

注释

Config.xml 文件中的 Command 元素和 OCT 中的“添加安装并运行程序”选项(在“添加程序项”和“修改程序项”对话框中输入的命令行)仅适用于初始产品安装和卸载。仅在初始安装和卸载过程中才会对 Command 元素命令进行处理。如果在初始安装后将 Command 元素命令用于自定义设置,则将忽略这些命令。

可以指定命令行运行任意命令或运行安装此程序时要运行的轻型可执行文件。

Config.xml 中的 Command 元素和 OCT 中的“添加安装并运行程序”选项不提供企业软件部署和管理工具提供的软件部署功能,如跟踪部署进度和对问题进行疑难解答功能。因此建议您对在 Config.xml 中使用 Command 元素和在 OCT 中使用“添加安装并运行程序”进行限制,使其只能运行不会对计算机进行更改或不需要用户输入任何内容的轻型可执行文件或任意命令。例如,您可以运行用于复制日志的实用工具或者用于在安装最后启动欢迎页面的命令。

Important重要信息
链接不如单独安装每个产品可靠。例如,如果您将两个安装链接在一起,当其中一个产品发生故障或遇到意外错误时,主安装和链接的安装可能无法成功完成。因此,建议不要使用链接方法。如果要在企业环境中同时安装多个产品,建议使用部署管理程序(如 Microsoft System Center Configuration Manager 2007 或 Microsoft Systems Management Server (SMS) 2003)或者第三方工具,而不是使用链接。

ArgsQuietArg 的用法如下:

  • Args 属性始终追加到命令。它可以包含 "/install" 或 **"Company=**MyCorporation" 等开关。

  • 如果安装程序以无提示方式运行(Display 设置为 Display="none"),则还会追加 QuietArg 属性。在此类情况下,您可以为 QuietArg 参数指定 "/quiet" 开关,例如您可以使用 QuietArg="/quiet"

以下说明适用于 Wait 属性:

  • Wait 属性设置为 0 毫秒表示在运行程序之后、继续安装之前无需等待;命令将立即执行并运行。

    仅在 Wait 为非零值时才会报告返回代码。如果指定 0,则在运行指定程序后,安装程序无需等待即可继续安装;因此,在这种情况下不会报告任何返回代码。

  • 如果将 Wait 属性设置为任何非零的正值,则等待的时间为您指定的毫秒数。如果在指定时间之前进程已经结束,则安装程序将继续。如果在指定时间后进程没有结束,则安装程序将失败。

  • Wait 属性设置为 -1 表示无期限等待。这样设置可能存在问题,因为如果命令进程停止响应(挂起),安装程序将停止响应,并且将无期限地等待命令运行。

如果 Config.xml 文件中有两个或多个 Command 元素,则这些元素会按照其在 Config.xml 中指定的顺序来运行。

示例

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />

COMPANYNAME 元素

在其计算机上安装产品的用户的单位或公司名称。

Tip提示
OCT 中等效的选项是安装位置和单位名称中的“单位名称”设置。

语法

<COMPANYNAME Value=" 公司名称 " />

属性

属性 说明

Value

公司名称

公司或单位名称

示例

<COMPANYNAME Value="Microsoft Corporation" />

Display 元素

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

Tip提示
OCT 中等效的选项是 2007 Office system 中的 Office 自定义工具的“授权和用户界面”中的“显示级别”和许可协议设置。

语法

<Display

   Level="None" | "Basic" | "Full"(默认值)

   CompletionNotice="Yes" | "No"(默认值)

   SuppressModal="Yes" | "No"(默认值)

   NoCancel="Yes" | "No"(默认值)

   AcceptEula="Yes" | "No"(默认值)

/>

属性

属性 说明

Level

None

不显示安装程序 UI。Display Level="none" 设置指示安装程序运行无提示安装(无人参与安装)。有关详细信息,请参阅注释部分。

Basic

安装程序显示“欢迎”屏幕、“产品密钥”(PIDKEY) 页面(如果需要)、最终用户许可协议 (EULA) 页面(如果需要)、进度栏以及完成通知(如果允许)。

Full(默认值)

安装程序对用户显示所有 UI。

CompletionNotice

Yes

仅在将 Level 设置为“Basic”或“None”时适用:安装程序显示完成通知。

No(默认值)

仅在将 Level 设置为“Basic”时适用:安装程序不显示完成通知。

SuppressModal

Yes

仅在将 Level 设置为“Basic”时适用:安装程序不显示可能中断安装的错误消息和其他对话框。

No(默认值)

仅在将 Level 设置为“Basic”时适用:安装程序根据需要显示错误消息和其他对话框。

NoCancel

Yes

如果将 Level 设置为“Full”或“Basic”,则会禁用取消按钮(进度对话框右上角的 X)。

No(默认值)

如果将 Level 设置为“Full”或“Basic”,则允许用户取消进度栏中的安装。

AcceptEULA

Yes

代表用户接受最终用户许可协议。安装程序不显示 EULA 页面。

No(默认值)

如果 Level 未设置为“None”,则安装程序将显示 EULA 页面。

注释

如果未定义该元素,将使用默认设置。如果指定了无效值,则安装程序将终止安装。

如果 Level 属性设置为“Basic”或“None”,并且您使用 PIDKEY 元素 元素提供了产品密钥,则安装程序会假定您同时代表用户接受了该许可协议。

Note注意
在企业部署中,我们建议您将 Display level 值设置为none,以确保安装程序运行无提示安装,而不提示用户输入信息,并且可避免在安装过程中等待任何用户交互(包括文件正在使用)。将 Display Level 值设置为 none 时假定 SuppressModalCompletionNotice 属性已设置为无提示并且接受了最终用户许可协议 (EULA)。管理员还必须确保在安装 2007 Office system 的过程中未运行任何 Office 应用程序。
如果将 Display level 值设置为 basicSuppressModal 值设置为yes,则任何 Office 文件正在使用时用户都会得到提示。在此类情况下,将 Display level 设置为 none 可阻止向用户发出提示。SuppressModal 属性不会阻止文件正在使用中的消息进行显示;只有将 Display level 设置为 none 时才会阻止该消息显示。
仅当安装程序在 setup.exe 所在的同一文件夹中找到 Config.xml 文件,或者您使用安装程序 /config 命令行选项指定 Config.xml 文件时,安装程序才会使用 Display 元素。如果安装程序使用产品文件夹中的 Config.xml 文件,则安装程序将使用默认显示选项。

示例

<Display Level="none" AcceptEula="Yes" />

DistributionPoint 元素

指定运行安装的网络安装点的完全限定路径。

语法

<DistributionPoint Location=" 路径 " />

属性

属性 说明

Location

路径

要运行安装的网络安装点的完全限定路径

注释

如果未指定此属性,安装程序则假定 Setup.exe 文件位于网络安装点的根目录中。

Note注意
仅当安装程序在 setup.exe 所在的同一文件夹中找到 Config.xml 文件,或者您使用安装程序 /config 命令行选项指定 Config.xml 文件时,安装程序才会使用 DistributionPoint 元素。如果安装程序使用产品文件夹中的 Config.xml 文件,由于已经找到了网络安装点,它将忽略此元素。

示例

<DistributionPoint Location="\\server1\office" />

INSTALLLOCATION 元素

指定用户计算机上产品安装文件夹的完全限定的路径。

Tip提示
OCT 中的等效选项是在安装位置和单位名称中的“默认安装路径”设置。

语法

<INSTALLLOCATION Value=" 路径 " />

属性

属性 说明

Value

路径

用户计算机上产品安装文件夹的完全限定的路径。

注释

可以在路径中使用系统环境变量。如果未指定此元素,将在 %ProgramFiles%\Microsoft Office 中安装 Office。

示例

<INSTALLLOCATION VALUE="%ProgramFiles%\MyApps" />

LIS 元素

控制本地安装源 (LIS) 如何缓存在用户计算机上,并指定一个或多个包含产品的安装文件的网络安装点位置。

语法

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST=" 分号分隔的路径列表 "]

/>

属性

属性 说明

CACHEACTION

CacheOnly

安装程序将 LIS 复制到用户的计算机上,但不会安装该产品。

RemoveCacheOnly

如果将缓存复制到用户的计算机上,但没有安装 Office,安装程序将会删除用户计算机中的 LIS,但不安装或卸载该产品。

SOURCELIST

分号分隔的路径列表

一个或多个包含产品的安装文件的网络安装点列表,该列表由分号分隔。

OCT 中的等效选项是其他网络资源

注释

默认情况下,将在安装了 Office 的驱动器根目录中的 \MsoCache\All Users 文件夹中创建 LIS,还会复制网络安装点的 Updates 文件夹中的安装程序自定义文件和软件更新。

如果指定了 INSTALLLOCATION 元素,路径中的驱动器标志则用于确定在哪个驱动器上创建 LIS。例如,如果 INSTALLLOCATION 元素 路径为 E:\office\files,则在驱动器 E 上创建 LIS。如果用户计算机上的本地安装源 (LIS) 丢失或损坏,由 SOURCELIST 属性列出的源将保留在已安装的产品中,并被安装程序所使用。

示例

<LIS CACHEACTION="CacheOnly" />   
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />

Logging 元素

指定安装程序执行的日志记录类型。

语法

<Logging

   Type="Off" | "Standard"(default) | "Verbose"

   Path="path"

   Template="filename.txt"

/>

属性

属性 说明

Type

Off

安装程序不进行日志记录。

Standard(默认值)

安装程序将安装信息写入日志文件。

Verbose

安装程序将所有安装信息写入日志文件。

Path

路径

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

Template

filename .txt

日志文件的名称。如果在文件名中的任意位置插入字符串 *,则会为 Setup.exe 执行的每个安装创建唯一的日志文件(请参阅下面的说明)。如果不包含 * 并且指定的文件名已存在,则日志信息会附加到现有文件中。必须包含 .txt 文件扩展名。默认模板为 SetupExe(*).log

注释

可以在 Template 值中的任意位置指定 *。安装程序会使用以下格式在该位置插入字符串:

YYYYMMDDHHMMSS xxx

其中:

  1. YYYY = 年

  2. MM = 月

  3. DD = 日

  4. HH = 小时

  5. MM = 分钟

  6. SS = 秒

  7. xxx = 安装程序生成的唯一字符串

Note注意
仅当安装程序在 setup.exe 所在的同一文件夹中找到 Config.xml 文件,或者您使用安装程序 /config 命令行选项来指定 Config.xml 文件时,安装程序才会使用 Logging 元素。如果安装程序使用产品文件夹中的 Config.xml 文件,安装程序则使用默认日志记录选项。

示例

<Logging Type="standard" Path="%temp%" 
   Template="MyLog(*).txt" 
/>

对于此示例,安装程序在每次安装产品时都会创建日志文件。安装程序使用如下所示的唯一文件名:

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

MinOSRequirement 元素

指定此产品最低支持的操作系统。

语法

<MinOSRequirement

   VersionNT="版本"

   WindowsBuild="编号"

   ServicePackLevel="编号"

/>

属性

属性 说明

VersionNT

版本

Windows NT 版本

WindowsBuild

编号

Windows 内部版本号

ServicePackLevel

编号

Windows Service Pack 编号

可以使用以下值。

系统 VersionNT WindowsBuild ServicePackLevel

Windows XP

501

2600

2 或更高版本

Windows Server 2003

502

3790

0 或更高版本

注释

如果用户计算机上的操作系统版本低于此处指定的版本(或未指定此元素,为 Office 的默认值),安装程序则不能继续进行安装。您不能在此处指定比 2007 Office system 所需版本低的 Microsoft Windows 版本。

有关系统要求的信息,请参阅 2007 Office system 入门

OptionState 元素

指定安装过程中如何处理特定的产品功能。

Important重要信息
在大多数的情况下,建议您使用 OCT 来更改功能的安装状态。OCT 中的等效选项是设置功能安装状态

语法

<OptionState

   Id="optionID"

   State="Absent" | "Advertise" | "Default" | "Local"

   [Children="force"]

/>

属性

属性 说明

Id

optionID

用户可以选择安装的项。

State

Absent

未安装该功能。

Advertise

该功能在首次使用时安装。

Default

该功能还原为其默认安装状态。

Local

该功能安装在用户的计算机上。

Children

force

将该功能的所有子功能设置为指定的状态。

注释

功能是用户可选择的要安装的项。某功能的 Id 值将在核心产品文件夹中 Setup.xml 文件的 Option 元素中进行定义。

有关 OptionState Id 值的列表,请参阅 Config.xml 文件的 OptionState ID 值。有关修改 Config.xml 文件中的 OptionState 元素的信息,请参阅使用组策略软件安装来部署 2007 Office system 中的修改 Config.xml 文件的 OptionState 元素部分。

示例

<OptionState Id="ExcelAddinFiles" 
   State="Absent" 
   Children="force" 
/>

PIDKEY 元素

由 25 个字符组成的批量许可证密钥。

Tip提示
OCT 中的等效选项是 2007 Office system 中的 Office 自定义工具中“授权和用户界面”的“产品密钥”设置。

语法

<PIDKEY Value=" 由 25 个字符组成的密钥 " />

属性

属性 说明

Value

由 25 个字符组成的密钥

由 25 个字符组成的批量许可证密钥

注释

如果设置了 PIDKEY 值,则用户在安装 Office 时无需输入产品密钥。

示例

<PIDKEY Value="1234512345123451234512345" />
Note注意
如果 Display 元素 元素的 Level 属性设置为“Basic”或“None”,并且您使用 PIDKEY 元素提供了产品密钥,安装程序将假定您同时代表用户接受了许可协议。在这种情况下,不管您如何设置 Display 元素 元素的 AcceptEULA 属性,在安装过程中或首次运行 Office 应用程序时都不会向用户提示许可协议。

RemoveLanguage 元素

从安装中删除指定的语言。

语法

<RemoveLanguage Id=" ll - cc " />

属性

属性 说明

Id

ll-cc

语言标识符。有关语言标记的完整列表,请参阅 2007 Office system 中的语言标识符

注释

如果不在用户计算机上安装语言,RemoveLanguage 元素将被忽略。

您可以具有多个 AddLanguage 元素 和 RemoveLanguage 元素。如果 RemoveLanguage 和 AddLanguage 元素 元素指定了同一个语言,则 AddLanguage 元素 元素将具有优先权并将安装该语言。

示例

<RemoveLanguage Id="en-us" />

Setting 元素

允许您指定 Windows Installer 属性的值。

Tip提示
OCT 中的等效选项是 2007 Office system 中的 Office 自定义工具中的“修改安装程序属性”。

语法

<Setting Id=" name " Value=" value " />

属性

属性 说明

Id

名称

Windows Installer 属性的名称

Value

要分配给属性的值

注释

并非所有 Windows Installer 属性都可在 Setting 元素中指定。如果指定了阻止的属性,安装程序将终止安装过程。如果指定了支持的属性,安装程序会将该属性直接传递到 Windows Installer。有关 Windows Installer 属性的完整列表(包括支持的属性和阻止的属性的说明),请参阅 2007 Office system 中的安装程序属性

Setting 元素支持 REMOVEPREVIOUS 设置。此设置将从安装中删除指定的应用程序并使用以下语法:

<Setting Id="REMOVEPREVIOUS" Value="Option Id" />

其中 选项 Id 是 2007 Office system 应用程序的标识符值。若要指定多个应用程序,请使用逗号分隔列表来表示适当的 选项 Id 值。有关选项 Id 值的完整列表,请参阅 Config.xml 文件的 OptionState ID 值

Note注意
如果要安装 Outlook,以前安装的 Outlook 版本始终会被删除,而不管用户的首选项是什么。

如果使用选项 Id 值来指定 REMOVEPREVIOUS,则只删除指定的应用程序。

如果不指定 REMOVEPREVIOUS,将会删除所有以前安装的 Office 应用程序,而安装新的 Office 应用程序。这是默认行为。

如果将 REMOVEPREVIOUS 指定为空值 (RemovePrevious =""),则不删除任何应用程序。

Setting 元素还支持 SETUP_REBOOT 属性。SETUP_REBOOT 会在安装后启动重新启动,并使用以下语法:

<Setting Id="SETUP_REBOOT" Value="value" />

其中可以是下列值之一:

  • AutoAlways - 始终启动重新启动。不提示用户。

  • Always - 始终在安装结束时提示重新启动。

  • IfNeeded - 如果安装程序要求重新启动,则在安装结束时提示重新启动。(默认)

  • AutoIfNeeded - 如果安装程序要求重新启动,则开始重新启动。不提示用户。

  • Never - 从不启动或提示重新启动。

示例

<Setting Id="SETUP_REBOOT" Value="NEVER" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />

SetupUpdates 元素

指定要用于查找安装程序自定义文件的安装程序的搜索路径。

语法

<SetupUpdates

   [CheckForSUpdates="Yes"(默认值)| "No"]

   [SUpdateLocation="路径列表"]

/>

属性

属性 说明

CheckForSUpdates

Yes(默认值)

安装程序使用 SUpdateLocation 中的路径列表来查找安装程序自定义文件。

No

安装程序不使用 SUpdateLocation 中的路径列表来搜索安装程序自定义文件。

SUpdateLocation

路径列表

由分号分隔的文件夹的完全限定路径的列表。

注释

安装程序在所有指定的文件夹中查找为安装的产品创建的安装程序自定义文件,并按文件名以字母顺序应用这些文件。如果已在安装程序命令行上指定了某个安装程序自定义文件,将首先应用该文件,然后再应用此元素指定的文件夹中找到的所有文件。

示例

<SetupUpdates
   CheckForSUpdates="Yes"
   SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>

USERINITIALS 元素

产品安装所在计算机的用户名的首字母缩写。

语法

<USERINITIALS Value=" " />

属性

属性 说明

Value

用户名的首字母缩写

示例

<USERINITIALS Value="JD" />

USERNAME 元素

产品安装所在计算机的用户名。

语法

<USERNAME Value=" " />

属性

属性 说明

Value

用户的名称。

注释

Office 2007 Username 元素数据将按以下方式填充。

如果运行 Office 的用户与安装 Office 的用户相同,将会使用安装过程中提供的 UsernameInitials。在首次启动 Office 时,将 会提示用户对此进行确认。这种情况最常见于自行安装 Office 的家庭用户。

如果运行 Office 的用户与安装 Office 的用户 相同,Office 将在首次启动 Office 时提示用户确认他或她的 UsernameInitials。这种情况最常见于管理员代表用户安装 Office 的企业环境中。

在第一次启动时向用户显示的 Username 元素的值可能会使用早期安装版本的 Office 或当前登录的用户的默认值进行预填充。请注意,除非用户已确认,否则 会使用默认值。如果计算机上安装了早期版本的 Office,将使用由早期版本的 Office 创建的注册表项。例如,如果以前安装的 Office 是 Office 2003,则在 HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo 中提供此注册表项。

示例

<USERNAME Value="John Doe" />

示例 Config.xml 文件

下例显示了典型安装的 Config.xml 文件。该示例使用产品的 Microsoft Office Enterprise 2007 版本。

Note注意
此文件的发布版本使用了 Command Path="msiexec.exe"。下例使用 Msiexec.exe 文件的完整路径:
Command Path="%WINDIR%\system32\msiexec.exe"
其中,%WINDIR % 是包含 Windows 文件的文件夹。您必须包括要运行该命令的完整路径,否则操作将失败。
<Configuration Product="Enterprise">

    <!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
    
    <!-- <Logging Type="verbose" Path="%temp%" Template="Microsoft Office Enterprise Setup(*).txt" /> -->
    
    <!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->

    <!-- <USERNAME Value="Customer" /> -->
    
    <!-- <COMPANYNAME Value="MyCompany" /> -->
    
    <!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->
    
    <!-- <LIS CACHEACTION="CacheOnly" /> -->
        
    <!-- <DistributionPoint Location="\\server\share\Office12" /> -->
    
    <!-- <OptionState Id="OptionID" State="absent" Children="force" /> -->
    
    <!-- <Setting Id="SETUP_REBOOT" Value="IfNeeded" /> -->
    
    <!-- <Command Path="%WINDIR%\system32\msiexec.exe" Args="/i \\server\share\my.msi" QuietArg="/q" ChainPosition="after" Execute="install" /> -->

</Configuration>

下载此书籍

本文包含在以下可下载书籍内,以方便您阅读和打印: