Config.xml 参考 (Office SharePoint Server)

项目
06/12/2012

如果要控制 Microsoft Office SharePoint Server 2007 的安装方式，请随 Setup.exe 一起使用 Config.xml 文件。例如，您可以使用 config.xml 文件进行以下操作：

执行 Office SharePoint Server 2007 的无提示安装。
通过使用跨多台服务器的通用配置安装 Office SharePoint Server 2007。
执行 Office SharePoint Server 2007 的自动安装或脚本化安装。

本文内容：

自定义 Config.xml
Config.xml 元素快速参考
工作原理
Config.xml 文件格式
Config.xml 元素参考

自定义 Config.xml

若要控制安装，请首先在文本编辑器中编辑 Config.xml 文件，以包括所需元素以及这些元素的适当设置。然后，运行 setup.exe /config [path and file name] 以指定 Setup.exe 运行并使用在 Config.xml 文件中设置的选项。

重要说明：
请使用文本编辑器（如“记事本”）来编辑 Config.xml。不要使用诸如 Microsoft Office Word 2007 等通用 XML 编辑器。

产品 DVD 包含 Config.xml 文件的示例。这些示例文件存储在 DVD 根目录的 \Files 文件夹下，位于与不同方案对应的文件夹中。这些文件夹为：

Setup 包含用于设置单一服务器干净安装（独立安装，包含 SQL Express）的 config.xml 文件。
SetupFarm 包含用于设置服务器场干净安装的 config.xml 文件。
SetupFarmSidebySide 包含用于逐步升级现有服务器场的 config.xml 文件。
SetupFarmSilent 包含用于以静默模式设置服务器场的 config.xml 文件。
SetupFarmUpgrade 包含用于就地升级现有服务器场的 config.xml 文件。
SetupSilent 包含用于以静默模式设置单一服务器干净安装（独立安装，包含 SQL Express）的 config.xml 文件。
SetupSingleUpgrade 包含用于就地升级现有单一服务器（独立服务器）的 config.xml 文件。

重要说明：
Office SharePoint Server 2007 附带的默认配置文件不包含 SETUP_REBOOT 设置。如果要在命令行安装过程中取消重新启动，您必须包括此设置。

有关各种升级方案的不同之处的详细信息，请参阅确定升级方法 (Office SharePoint Server)。

Config.xml 元素快速参考

下表列出了 Config.xml 中的元素。除了 Configuration（该元素必须是第一个元素）和诸如 Command 等元素（这些元素在 Config.xml 中的顺序会影响在安装过程中对其进行处理的方式）外，这些元素可按任何顺序出现。

元素	说明
Configuration	顶级元素。
ARP	对控制面板中用于产品的“添加或删除程序”的文本和行为进行控制的值。
Command	在安装过程中运行命令。
Display	安装程序向用户显示的 UI 的级别。
INSTALLLOCATION	用户计算机上产品安装文件夹的完全限定的路径。
Logging	表示安装程序所执行日志记录类型的选项。
DATADIR	用于存储数据文件的位置。
Package	要安装的程序包或产品。
PIDKEY	由 25 个字符组成的批量许可证密钥。
Setting	Windows Installer 属性的值。

工作原理

安装程序在 Setup.exe 所在的文件夹中查找 Config.xml 的副本。如果在那里未找到副本，安装程序将使用位于所安装产品的核心 \Files 文件夹中的 Config.xml 文件。

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

\\<服务器>\<共享>\setup.exe /config \\<服务器>\<共享>\<文件夹>\config.xml

Config.xml 文件格式

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

基本元素格式为：

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

例如：

<Display Level="none" CompletionNotice="no" />

元素和属性区分大小写。属性值必须括在引号 (") 中，并且不区分大小写。

元素定义可以跨越多行。元素定义内的空格、回车、换行符以及制表符将被忽略。

例如：

<Display
   Level="none"
   CompletionNotice="no"
/>

提示

对于较长的元素定义，请将属性放在单独的行上，并使用缩进以使文件的可读性更好。

Configuration 元素是一个特例，并且是必需元素。所有其他元素都包含在 Configuration 元素内，并且该元素以 </Configuration> 结束。

以下示例显示一个用于 Windows SharePoint Services 3.0 程序包干净安装的示例配置文件：

<Configuration>

<Package Id="sts">

<Setting Id="REBOOT" Value="ReallySuppress"/>

<Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

</Package>

<DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>

<Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>

<Setting Id="UsingUIInstallMode" Value="1"/>

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

</Configuration>

重要说明：
Office SharePoint Server 2007 附带的默认配置文件不包含 SETUP_REBOOT 设置。如果要在命令行安装过程中取消重新启动，您必须包括此设置。

可以在任何位置添加注释，并且注释由“”与其他内容分隔。

例如：

<Configuration>

<Package Id="sts">

<Setting Id="REBOOT" Value="ReallySuppress"/>

<Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

</Package>

<DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>

<Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>

<Setting Id="UsingUIInstallMode" Value="1"/>

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

</Configuration>

Config.xml 元素参考

本参考的说明中使用以下约定：

加粗	元素或属性名称
常规	要完全按照显示输入的文本
倾斜	要添加的值的占位符
x\|y	在多个值之间进行选择
[x]	可选值

Configuration 元素

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

语法

...

</Package>

...

</Configuration>

属性

属性	值	说明
Package ID	程序包 ID	所安装的程序包。

备注

Package Id 属性标识受此 Config.xml 文件影响的产品和技术。

示例

Office SharePoint Server 2007 的程序包 ID 为 spswfe。由于 Office SharePoint Server 2007 基于 Windows SharePoint Services 3.0 中的平台技术，因此您还必须安装 sts (Windows SharePoint Services 3.0) 程序包，否则安装将不会成功。

通过输入以下内容，在 Config.xml 中使用 sts 和 spswfe 程序包 ID 来指定 Windows SharePoint Services 3.0 和 Office SharePoint Server 2007：

<Configuration>
   <Package Id="sts">
   ...
   </Package>
   ...
   <Package Id="spswfe">
   ...
   </Package>
   ...
</Configuration>

ARP 元素

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

语法

属性

属性	值	说明
ARPCOMMENTS	文本	附加文本；最多可为 255 个字符，尽管所有字符可能都不会显示。
ARPCONTACT	文本	技术支持联系人列表。
ARPNOMODIFY	Yes	通过使“更改”按钮不可用，防止用户修改安装的产品。
	No（默认值）	允许用户修改安装的产品。
ARPNOREMOVE	Yes	通过使“删除”按钮不可用，防止用户删除产品。
	No（默认值）	允许用户删除产品。
ARPURLINFOABOUT	URL	产品主页的 URL。
ARPURLUPDATEINFO	URL	产品更新相关信息的 URL。
ARPHELPLINK	URL	用户可从中获得技术支持的网站的 URL。
ARPHELPTELEPHONE	文本	技术支持电话号码。

Command 元素

指定要运行的命令行。只会在初次安装和卸载过程中处理 Command 元素的命令。如果 Command 元素的命令用于初次安装后的自定义，这些命令将被忽略。

语法

<Command

Path="路径"

[QuietArg="参数"]

[Args="参数"]

[ChainPosition="Before" | "After"（默认值）]

[Wait="毫秒数"]

[QuietWait="毫秒数"]

[Execute="Install"（默认值）| "Uninstall"]

[Platform="x86"（默认值）| "x64"]

属性

通过同时指定两个双引号 ("")，您可以在 Path 和 Args 属性中指定双引号 (")。

属性	值	说明
Path	路径	可执行的 Microsoft® Windows Installer (MSI) 程序包文件的完全限定的路径。
QuietArg	字符串	当发生 Display Level=None 这样的情况时要追加到命令行结尾的参数字符串。
Args	字符串	要传递到可执行文件的参数字符串。
ChainPosition	Before	在主产品安装之前执行此命令。
	After（默认值）	在主产品安装之后执行此命令。
Wait	毫秒数	如果在 Display Level 属性设置为“Full”或“Basic”的情况下进行安装，这是在运行程序之后继续安装之前等待的毫秒数。默认值为 0（零），指示不等待。
QuietWait	毫秒数	如果在 Display Level 属性设置为“None”的情况下进行安装，这是在运行程序之后继续安装之前等待的毫秒数。默认值为 0（零），指示不等待。
Execute	Install（默认值）	安装程序在安装了主产品后执行此命令。
	Uninstall	安装程序在卸载了主产品后执行此命令。
Platform	x86（默认值）	指定此程序需要 Intel x86 平台。只有当运行安装的计算机符合此平台要求时，此命令才会运行。
	x64	指定此程序需要可支持 x86 体系结构的 x64 扩展的 64 位处理器。只有当运行安装的计算机符合此平台要求时，此命令才会运行。

备注

可以为连锁安装或在此产品安装后运行的可执行文件指定命令行。如果指定了此元素，您必须为 Setup.exe（而不是单一 MSI 文件）指定命令行。

如果 Config.xml 文件中有两个或更多 Command 元素，则这些元素将按在 Config.xml 中指定它们时所采用的顺序运行。

示例

<Command Path=”myscript.exe” Args=”/id ""123 abc"" /q”/>

<Command Path="\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml"

DATADIR 元素

用于存储数据文件（包括搜索索引文件）的位置。

语法

属性

属性	值	说明
Value	路径	安装程序将数据文件存储在指定位置中。

备注

可以在路径中使用系统环境变量。如果未指定此元素，则数据存储在以下路径中：

%PROGRAMFILES%\Microsoft Office Servers\12.0\Data

示例

<DATADIR Value=”d:\data”/>

Display 元素

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

语法

<Display

Level="None" | "Basic" | "Full"（默认值）

CompletionNotice="Yes"（默认值）| "No"

SuppressModal="Yes" | "No"（默认值）

NoCancel="Yes" | "No"（默认值）

AcceptEula="Yes" | "No"（默认值）

属性

属性	值	说明
Level	None	不显示安装程序 UI。
	Basic	安装程序显示“欢迎”屏幕、“产品密钥”(PIDKEY) 页面（如果需要）、“Microsoft 软件许可条款”页面（如果需要）、进度栏以及完成通知（如果允许）。
	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	代表用户接受 Microsoft 软件许可条款；安装程序不显示“Microsoft 软件许可条款”页面。
	No（默认值）	如果 Level 未设置为“None”，安装程序将显示“Microsoft 软件许可条款”页面。

备注

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

如果 Level 属性设置为“Basic”或“None”，并且您通过使用 PIDKEY 元素提供了产品密钥，安装程序将假定您同时代表用户接受了许可条款。在这种情况下，不管如何设置 AcceptEULA 属性，在安装过程中都不会向用户提示许可条款。

备注

只有当安装程序在 setup.exe 所在的文件夹中找到 Config.xml 文件，或者您通过使用安装程序的 /config 命令行选项指定了 Config.xml 文件时，安装程序才会使用 Display 元素。

示例

<Display Level=”basic”
   CompletionNotice=”yes”
   SupressModal=”no”
   AcceptEula=”yes”
/>

INSTALLLOCATION 元素

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

语法

属性

属性	值	说明
Value	路径	用户计算机上产品安装文件夹的完全限定的路径。

备注

可以在路径中使用系统环境变量。如果未指定此元素，产品将安装在以下路径中：

%PROGRAMFILES%\Microsoft Office Servers\12.0\

请注意，Windows SharePoint Services 3.0 技术不受此元素的影响；它将安装到以下路径中：

%PROGRAMFILES%\Common Files\Microsoft Shared\web server extensions\12

示例

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

Logging 元素

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

语法

<Logging

Type="Off" | "Standard"（默认值）| "Verbose"

Path="路径"

Template="文件名.txt"

属性

属性	值	说明
Type	Off	安装程序不记录日志。
	Standard（默认值）	安装程序将安装信息写入日志文件。
	Verbose	安装程序将所有安装信息写入日志文件。
Path	路径	用于日志文件的文件夹的完全限定的路径。您可以使用环境变量。默认值为 %temp%。
Template	文件名.txt	日志文件的名称。如果在文件名中的任何位置插入字符串，则会为 Setup.exe 执行的每次安装创建唯一的日志文件（请参阅下面的说明）。如果未包括并且指定的文件名已存在，则会将日志信息追加到现有文件的结尾。必须包括 .txt 文件扩展名。默认模板为 SetupExe(*).log。

备注

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

YYYYMMDDHHMMSSxxx

其中：

YYYY = 年
MM = 月
DD = 日
HH = 小时
MM = 分钟
SS = 秒
xxx = 安装程序生成的唯一字符串

备注

只有当您通过使用安装程序的 /config 命令行选项指定了 Config.xml 文件时，安装程序才会使用 Logging 元素。如果未指定要使用的 Config.xml 文件，则安装程序将使用默认日志记录选项。

示例

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

对于此示例，安装程序将在每次安装产品时创建一个日志文件。安装程序使用诸如以下唯一文件名：

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

Package 元素

要安装的程序包或产品。

PIDKEY 元素

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

语法

属性

属性	值	说明
Value	由 25 个字符组成的密钥	由 25 个字符组成的批量许可证密钥。

备注

如果设置了 PIDKEY 值，则用户在运行安装程序时无需输入产品密钥。

示例

<PIDKEY Value="1234512345123451234512345" />

备注

如果 Display 元素的 Level 属性设置为“Basic”或“None”，并且您通过使用 PIDKEY 元素提供了产品密钥，安装程序将假定您同时代表用户接受了许可条款。在这种情况下，不管如何设置 Display 元素的 AcceptEULA 属性，在安装过程中都不会向用户提示许可条款。

Setting 元素

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

语法

属性

属性	值	说明
Id	名称	Windows Installer 属性的名称。
Value	值	要赋给属性的值。

值

以下 Setting ID 用于服务器安装：

ID	接受的值	说明
LAUNCHEDFROMSETUPSTS	Yes \| No	用作 Package Id 属性的一部分。默认值为 Yes。
REBOOT	ReallySuppress	（为 Windows Installer）指定在安装程序完成后是否允许重新启动。使用 ReallySuppress 以指定不重新启动。必须在全局级别（而不是按程序包）指定。
SETUP_REBOOT	Never、AutoAlways、Always、AutoIfNeeded、IfNeeded	（为 Setup.exe）指定在安装程序完成后是否允许重新启动。使用 Never 以指定不重新启动。必须在全局级别（而不是按程序包）指定。
SETUPTYPE	CLEAN_INSTALL、V2V_GRADUAL_UPGRADE、V2V_INPLACE_UPGRADE、SKU2SKU_UPGRADE	指定是安装产品或技术的新副本 (CLEAN_INSTALL)、将新版本与以前的版本并排安装以进行逐步升级 (V2V_GRADUAL_UPGRADE)、安装新版本并就地升级以前的版本 (V2V_INPLACE_UPGRADE)，还是从一个产品升级到另一个产品（例如从 Windows SharePoint Services 3.0 升级到 Office SharePoint Server 2007）。必须在全局级别（而不是按程序包）指定。
SETUPCALLED	0 \| 1	用作 Package Id 属性的一部分。
OFFICESERVERPREMIUM	0 \| 1	用作 Package Id 属性的一部分。指定要安装 Office SharePoint Server 2007 的哪个版本：Standard (0) 或 Enterprise (1)。请注意，使用的 PIDKEY 将覆盖此设置。
SERVERROLE	SINGLESERVER、WFE、APPLICATION	指定要安装到的服务器的类型：独立服务器 (SINGLESERVER)、前端 Web 服务器 (WFE) 或应用程序服务器 (APPLICATION)。
USINGUIINSTALLMODE	0 \| 1	指定是执行无提示安装 (0) 还是为安装程序使用用户界面 (1)。

备注

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

示例

<Setting Id="REBOOT" Value="ReallySuppress" />

下载书籍

本主题包含在以下可下载书籍内，以方便您阅读和打印：

Microsoft Office SharePoint Server 2007 安装指南

有关可下载书籍的完整列表，请参阅 Office SharePoint Server 2007 的可下载书籍。