Config.xml 參考 (Windows SharePoint Services)

  • 發行項

當您要控制 Windows SharePoint Services 3.0 的安裝方式時，請同時使用 Config.xml ** 檔案及 Setup.exe。例如，您可以使用 config.xml 檔案來執行下列作業：

  • 執行 Windows SharePoint Services 3.0 的無訊息安裝。

  • 使用多部伺服器的通用設定來安裝 Windows SharePoint Services 3.0。

  • 執行 Windows SharePoint Services 3.0 的自動安裝或以指令碼安裝。

本文內容：

  • 自訂 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   包含用來設定全新安裝的 config.xml 檔案。您必須先執行 psconfig.exe，再執行安裝程式，完成設定伺服器或伺服器陣列。

  • SetupFarmSilent 包含以無訊息模式設定伺服器陣列所使用的 config.xml 檔案。

  • SetupGradualUpgradeSilent   包含用來逐步升級現有伺服器陣列的 config.xml 檔案。

  • SetupSilent   包含以無訊息模式來設定單一伺服器 (獨立式且具有 Windows Internal Database) 全新安裝的 config.xml 檔案。

  • SetupUpgradeSilent   包含用來逐步升級現有伺服器陣列的 config.xml 檔案。

重要

Windows SharePoint Services 3.0 隨附的預設設定檔會省略 SETUP_REBOOT 設定。若不要在命令列安裝期間進行重新開機，則必須加入此項設定。

如需各種升級案例之差異的詳細資訊，請參閱＜決定升級方法 [Windows SharePoint Services]＞。

Config.xml 元素快速參考

下表包含 Config.xml 中的元素清單。這些元素可依任何順序出現，但Configuration必須是第一個，而像Command等元素在 Config.xml 中的順序則會影響其在安裝期間的處理方式。

元素

描述

Configuration

最上層元素。

ARP

這些值是用來控制產品在 [控制台] 中 [新增或移除程式] 的文字和行為。

Command

在安裝期間執行命令。

Display

使用者會看到的安裝程式 UI 層級。

Logging

安裝程式執行的記錄類型選項。

DATADIR

用以儲存資料檔案的位置。

Package

要安裝的套件或產品。

Setting

Windows Installer 屬性值。

運作方式

安裝程式會在 Setup.exe 所在的相同資料夾中尋找 Config.xml 的複本。此處若找不到複本，安裝程式會使用要安裝產品之核心 \Files 資料夾中的 Config.xml 檔案。

您也可以使用 /config 安裝程式命令列選項，指定 Config.xml 檔案的位置。例如：

\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml

Config.xml 檔案格式

Config.xml 中的 XML 元素是以 < 開頭，而以 /> 結尾。

基本元素格式為：

<element_name [attribute_name="值"] [attribute_name="值"] … />

例如：

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

重要事項   Windows SharePoint Services 3.0 隨附的預設設定檔案會省略 SETUP_REBOOT 設定。若不要在命令列安裝期間進行重新開機，則必須加入此項設定。

註解可以加在任何位置，並要使用 "<!--" 及 "-->" 隔開。

例如：

<!-- Install Windows SharePoint Services for clean install, using UI-->

<Configuration>

   <Package Id="sts">

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

      <!-- Tells Windows Installer not to reboot -->

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

   <!-- Tells Setup.exe not to reboot -->

</Configuration>

Config.xml 元素參考

本參考中的描述使用以下慣例：

粗體

元素或屬性名稱

一般

輸入與顯示內容完全相同的文字

*斜體*

新增值的預留位置

*x*|*y*

從多個值之間選擇

[*x*]

選用值

Configuration 元素

最上層元素。此為必要元素，且所有其他元素皆必須出現在此元素內。

語法

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

屬性

屬性

值

描述

Package ID

*套件識別碼*

正在安裝的套件。

備註

Package Id 屬性可識別此 Config.xml 檔案會影響的產品及技術。

範例

Windows SharePoint Services 3.0 的套件識別碼為 sts。Config.xml 中的 sts 套件識別碼可以用來指定 Windows SharePoint Services 3.0，請輸入下列命令：

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

ARP 元素

指定用來控制產品在 [控制台] 中 [新增或移除程式] 之文字和行為的值。

語法

<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="arguments"]

[Args="args"]

[ChainPosition="Before" | "After"(預設值)]

[Wait="mseconds"]

[QuietWait="mseconds"]

[Execute="Install"(預設值) | "Uninstall"]

[Platform="x86"(預設值) | "x64"]

/>

屬性

指定兩個相連的雙引號 ("")，即可在 Path 及 Args 屬性中指定雙引號 (")。

屬性

值

描述

Path

*路徑*

可執行檔 Microsoft® Windows Installer (MSI) 套件檔案的完整路徑。

QuietArg

*string*

當 Display Level=None 時，會附加至命令列的引數字串。

Args

*string*

要傳遞至可執行檔的引數字串。

ChainPosition

Before

執行主要產品安裝之前，先執行此命令。

After (預設值)

執行主要產品安裝之後，才執行此命令。

Wait

*毫秒*

這是使用設為 "Full" 或 "Basic" 的 Display Level屬性執行安裝時，這是在執行程式之後，繼續安裝之前所需等候的毫秒數。預設值為 0 (零)，這代表不需等候。

QuietWait

*毫秒*

這是以設為 "None" 的 Display Level屬性執行安裝時，這是在執行程式之後，繼續安裝之前所需等候的毫秒數。預設值為 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 元素

用以儲存資料檔案的位置，包括搜尋索引檔案。

語法

<DATADIR Value="路徑"/>

屬性

屬性

值

描述

Value

路徑

安裝程式會將資料檔案儲存在指定的位置。

備註

路徑中可以使用系統環境變數。若未指定此元素，資料即會儲存在下列路徑：

%ProgramFiles%\Microsoft SQL Server\MSSQL$SHAREPOINT\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

安裝程式會顯示 [歡迎使用] 畫面、[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 軟體授權合約] 頁面。

備註

若未定義此元素，即使用預設設定。若指定的值無效，安裝程式即會結束安裝。

注意

只有當安裝程式在 setup.exe 所在的相同資料夾中找到 Config.xml 檔案，或當您使用 Setup /config 命令列選項來指定 Config.xml 檔案時，安裝程式才會使用 Display 元素。

範例

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

Logging 元素

指定安裝程式執行的記錄類型。

語法

<Logging

Type="Off" | "Standard"(預設值) | "Verbose"

Path="路徑"

Template="檔案名稱.txt"

/>

屬性

屬性

值

描述

Type

Off

安裝程式不進行記錄。

Standard (預設值)

安裝程式會將安裝資訊寫入記錄檔。

Verbose

安裝程式會將所有安裝資訊寫入記錄檔。

Path

*路徑*

記錄檔所使用的資料夾完整路徑。您可以使用環境變數。預設值為 %temp%。

Template

*檔案名稱*.txt

記錄檔的名稱。若在檔案名稱的任何位置插入字串 *，即會為 Setup.exe 所執行的每個安裝作業建立唯一的記錄檔 (請見後文說明)。若不包含 * 且指定的檔案名稱已存在，就會將記錄資訊附加到現有的檔案。請務必包含 .txt 副檔名。預設範本為 SetupExe(*).log。

備註

您可以在 Template 值的任何位置指定 *。安裝程式會在該位置插入下列格式的字串：

YYYYMMDDHHMMSSxxx

其中：

  1. YYYY = 年

  2. MM = 月

  3. DD = 日

  4. HH = 小時

  5. MM = 分鐘

  6. SS = 秒

  7. xxx = 安裝程式所產生的唯一字串

注意

只有當您使用 Setup /config 命令列選項指定 Config.xml 檔案時，安裝程式才會使用 Logging 元素。若不指定要使用的 Config.xml 檔案，安裝程式會使用預設的記錄選項。

範例

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

本例中，安裝程式每次安裝產品時都會建立記錄檔。安裝程式使用唯一的檔案名稱，如下所示：

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

Package 元素

要安裝的套件或產品。

Windows SharePoint Services 3.0 的套件識別碼為 sts。

Setting 元素

可讓您指定 Windows Installer 屬性值。

語法

<Setting Id="名稱" Value="值" />

屬性

屬性

值

描述

Id

*name*

Windows Installer 屬性的名稱。

Value

*value*

要指派給屬性的值。

值

下列設定識別碼用於伺服器安裝：

識別碼

接受的值

描述

REBOOT

ReallySuppress

指定 (適用於 Windows Installer) 是否允許在安裝完成後重新開機。使用 ReallySuppress 表示指定不重新開機。必須在共用層指定，而非在每個套件指定。

SETUP_REBOOT

永遠不要 (Never)、一律自動 (AutoAlways)、永遠 (Always)、需要時自動 (AutoIfNeeded)、需要時 (IfNeeded)

指定 (適用於 Setup.exe) 是否允許在安裝完成後重新開機。使用「永遠不要」(Never) 表示不重新開機。必須在共用層指定，而非在每個套件指定。

SETUPTYPE

CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE

指定是否要安裝全新的產品或技術 (CLEAN_INSTALL)、要將新版本與舊版本併行安裝逐步升級 (V2V_GRADUAL_UPGRADE)，還是就地安裝新版本並升級舊版本 (V2V_INPLACE_UPGRADE)。必須在共用層指定，而非在每個套件指定。

SETUPCALLED

0 | 1

用為 Package Id 屬性的一部分。

SERVERROLE

SINGLESERVER, WFE

指定要安裝至目的地的伺服器類型：獨立 (SINGLESERVER) 或前端網頁伺服器 (WFE)。

USINGUIINSTALLMODE

0 | 1

指定要執行無訊息安裝 (0) 或使用安裝程式的使用者介面 (1)。

備註

不是所有 Windows Installer 屬性皆可以指定在 Setting 元素中。若指定封鎖的屬性，安裝程式即會結束安裝程序。若指定支援的屬性，安裝程式會將該屬性直接傳送至 Windows Installer。

範例

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

下載本書

本主題隨附於下列可下載的叢書中，以便於閱讀與列印：

請參閱Windows SharePoint Services 可下載的叢書 上提供的完整叢書清單。