Office 2010 中的 Config.xml 文件

语法

<Configuration [Product="productID"] >

   ...

</Configuration>

属性

备注

Product 属性标识受此 Config.xml 文件影响的产品。productID 是在 Setup.xml 文件（位于产品的核心文件夹中）中用 Setup 元素的 ID 属性定义的。

Product 属性是可选的，除非您将 Display 元素Level 属性设置为“basic”或“none”。在此情况下，Product 属性是必需的。如果网络安装点中没有 Product 属性所指定的产品，则安装程序将结束安装。

示例

Microsoft Office Professional Plus 2010 的 productID 位于 ProPlus.WW\Setup.xml 中的以下行：

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

通过输入以下内容，可以在 Config.xml 中使用此 productID 指定 Office Professional Plus 2010：

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

语法

<AddLanguage

   Id="ll-cc" | "match"

   [ShellTransform="Yes"]

/>

属性

备注

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

AddLanguage 和 RemoveLanguage 元素 可以有多个元素。如果 RemoveLanguage 元素 和 AddLanguage 元素都指定同一种语言，则 AddLanguage 元素将优先并会安装该语言。

安装 Office 2010 时，应了解以下三个语言概念：

• 安装程序用户界面 (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 属性。AddLanguage 将指定安装程序对外壳 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 attribute =" value " [attribute**="value"**] ... />

属性

语法

<Command

   Path="path"

   [QuietArg="arguments"]

   [Args="args"]

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

   [Wait="mseconds"]

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

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

/>

属性

下表描述 Command 元素属性。

备注

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

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

Config.xml 中的 Command 元素和 OCT 中的“添加安装并运行程序”选项不会提供企业软件部署和管理工具所提供的软件部署功能，如跟踪部署进度和解决问题的功能。因此，建议您限制使用 Config.xml 中的 Command 元素和 OCT 中的“添加安装并运行程序”，以便仅运行不会对计算机进行更改或者不要求用户输入的轻型可执行文件或任意命令。例如，您可以使用实用工具复制日志，或使用命令在安装结束时启动“欢迎”页。

对 Args 和 QuietArg 的使用如下所示：

• Args 属性始终会附加到命令。这可能包括诸如 "/install" 或 **"Company=**MyCorporation" 之类的开关。

• 如果安装程序以无提示方式运行（Display 设置为 Display="none"），还会附加 QuietArg 属性。在此情况下，可以使用 "/quiet" 开关指定 QuietArg 属性，例如，您可以使用 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 Value=" companyname " />

属性

示例

<COMPANYNAME Value="Microsoft Corporation" />

语法

<Display

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

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

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

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

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

/>

属性

备注

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

如果 Level 属性设置为“basic”或“none”，并且您通过使用 PIDKEY 元素 提供了产品密钥，则安装程序假定您也代表用户接受许可协议。

示例

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="Yes" />

语法

<DistributionPoint Location=" path " />

属性

备注

如果未指定该路径，则安装程序将假定 Setup.exe 文件位于网络安装点的根目录下。

示例

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

语法

<INSTALLLOCATION Value=" path " />

属性

备注

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

示例

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

语法

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST=" semicolon-delimited-path-list "]

/>

属性

备注

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

如果指定 INSTALLLOCATION 元素，则可以使用路径中的驱动器标志来确定创建 LIS 的驱动器。例如，如果 INSTALLLOCATION 元素 路径是 E:\office\files，则在驱动器 E 上创建 LIS。SOURCELIST 属性列出的源与安装的产品一起保留，并在用户计算机上的 LIS 丢失或已损坏时由安装程序使用。

示例

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

语法

<Logging

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

   Path="path"

   Template="filename.txt"

/>

属性

备注

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

YYYYMMDDHHMMSS xxx

其中：

1. YYYY = 年

2. MM = 月

3. DD = 日

4. HH = 小时

5. MM = 分钟

6. SS = 秒

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

示例

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

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

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

语法

<MinOSRequirement

   VersionNT="version"

   WindowsBuild="number"

   ServicePackLevel="number"

/>

属性

可以使用以下值。

备注

如果用户计算机上的操作系统的版本低于此处指定的版本（如果未指定此元素，则为 Office 的默认版本），则安装程序将不会继续安装。此处指定的 Windows 版本不能低于 Office 2010 所需的版本。

有关系统要求的信息，请参阅 Office 2010 中针对 IT 专业人员的新增功能。

语法

<OptionState

   Id="optionID"

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

   [Children="force"]

/>

属性

备注

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

示例

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

语法

<PIDKEY Value=" 25-character-key " />

属性

备注

设置 PIDKEY 值后，用户在安装 Office 时将无需输入产品密钥。

若要在 Config.xml 文件中输入 MAK 密钥，请在该文件中添加以下行。

<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />

其中，AAAAABBBBBCCCCCDDDDDEEEEE 是 25 个字符的产品密钥。有关 Office 2010 的授权的详细信息，请参阅 Office 2010 的批量激活概述。

示例

<PIDKEY Value="1234512345123451234512345" />

语法

<RemoveLanguage Id=" ll - cc " />

属性

备注

如果未在用户计算机上安装此语言，则将忽略 RemoveLanguage 元素。

AddLanguage 元素 和 RemoveLanguage 可以有多个元素。如果 RemoveLanguage 和 AddLanguage 元素 元素都指定同一种语言，则 AddLanguage 元素 元素优先，并安装该语言。

示例

<RemoveLanguage Id="en-us" />

语法

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

属性

备注

并不能在 Setting 元素中指定所有 Windows Installer 属性。如果指定一个已阻止属性，则安装程序将结束安装进程。如果指定一个受支持属性，则安装程序会直接将此属性传递给 Windows Installer。有关 Windows Installer 属性的完整列表（其中包括受支持属性和已阻止属性的说明），请参阅 Office 2010 中的安装程序属性。

Setting 元素支持以下密钥管理系统 (KMS) 属性：

• KMSSERVICENAME - 指定 KMS 主机名。

• KMSSERVICEPORT - 指定 KMS 主机端口。

例如，若要使用 KMS 属性，请使用以下语法：

<Setting Id="KMSSERVICENAME" Value="contoso.com" />

<Setting Id="KMSSERVICEPORT" Value="1234" />

其中：

contoso.com 是 KMS 主机的名称

1234 是端口号值

Setting 元素支持用于产品密钥激活的 AUTO_ACTIVATE 属性。此属性指定在部署 Office 2010 的过程中自动进行产品激活，并使用以下语法。

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

Setting 元素支持 REMOVEPREVIOUS 属性。此属性可从安装中删除指定应用程序并使用以下语法。

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

其中，Option Id 是 Office 2010 应用程序的标识符值。若要指定多个应用程序，请使用以逗号分隔的列表来指示适当的 Option Id 值。

如果使用 Option Id 值指定 REMOVEPREVIOUS，则仅删除指定的应用程序。

如果未指定 REMOVEPREVIOUS，则将删除要为其安装替换应用程序的之前安装的任何 Office 应用程序。这是默认行为。

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

Setting 元素还支持 SETUP_REBOOT 属性。SETUP_REBOOT 在安装后开始重新启动。它使用以下语法。SETUP_REBOOT 属性必须全部使用大写字母。

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

其中，value 可以是下列值之一：

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

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

• IfNeeded - 如果安装程序需要重新启动，则在安装程序结束时提示重新启动。（默认）

• AutoIfNeeded - 如果安装程序需要重新启动，则执行重新启动。不提示用户。

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

示例

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

语法

<SetupUpdates

   [CheckForSUpdates="Yes"（默认）| "No"]

   [SUpdateLocation="path-list"]

/>

属性

备注

安装程序在所有指定的文件夹中查找为要安装的产品创建的安装程序自定义文件，然后按文件名的字母顺序应用这些文件。如果已在安装程序命令行中指定一个安装程序自定义文件，则先应用该文件，再应用在此元素所指定的文件夹中找到的任何文件。

示例

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

语法

<USERINITIALS Value=" value " />

属性

示例

<USERINITIALS Value="JD" />

语法

<USERNAME Value=" value " />

属性

备注

将如下方式填充 Office 2010  Username 元素数据。

如果运行 Office 的用户即为安装 Office 的用户，则使用在安装过程中提供的 Username 和 Initials。Office 在首次启动时不会 向用户发出提示。对于自行安装 Office 的家庭用户，此情况最为常见。

如果运行 Office 的用户不是 安装 Office 的用户，则 Office 在首次启动时会提示用户确认其 Username 和 Initials。此情况在由管理员为用户安装 Office 的企业环境中最为常见。

首次启动时，可能会用默认值（来自之前安装的 Office 版本或来自当前已登录用户）预填充为用户显示的 Username 元素的值。请注意，该默认值仅在获得用户确认后才使用。如果在计算机上安装了早期版本的 Office，则使用由早期版本的 Office 创建的注册表项。例如，如果之前安装的 Office 是 Microsoft Office 2003，则注册表项位于 HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo 中。

示例

<USERNAME Value="John Doe" />