Config.xml 參考 (Office SharePoint Server)
當您要控制 Microsoft Office SharePoint Server 2007 的安裝方法時，請同時使用 Config.xml 檔案及 Setup.exe。例如，您可以使用 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 元素以 < 開頭且以 /> 結尾。
基本元素格式為：
<element_name [attribute_name="值"] [attribute_name="值"] … />
例如：
<Display Level="none" CompletionNotice="no" />
元素和屬性區分大小寫。屬性值必須括以引號 (")，但不區分大小寫。
元素定義可跨越多行。元素定義中的空格、換行字元和換行符號以及定位字元概予忽略。
例如：
<Display
Level="none"
CompletionNotice="no"
/>
.gif "提示") 秘訣： |
|---|
針對長元素定義，請單獨將屬性放置在每一行，並使用縮排以方便閱讀檔案。 |
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 設定。若不要在命令列安裝期間進行重新開機，則必須加入此項設定。
註解可以加在任何位置，以 "<!--" 及 "-->" 隔開。
例如：
<!-- 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="識別碼">
...
</Package>
...
</Configuration>
屬性
屬性 |
值 |
描述 |
Package ID |
*套件識別碼* |
正在安裝的套件。 |
備註
Package Id 屬性可識別受此 Config.xml 檔案影響的產品及技術。
範例
Office SharePoint Server 2007 的套件識別碼為 spswfe。因為 Office SharePoint Server 2007 係以 Windows SharePoint Services 3.0 的平台技術為基礎，所以您也必須安裝 sts (Windows SharePoint Services 3.0) 套件，否則安裝無法成功。
請輸入以下內容，使用 Config.xml 中的 sts 及 spswfe 套件識別碼，指定 Windows SharePoint Services 3.0 及 Office SharePoint Server 2007：
<Configuration>
<Package Id="sts">
...
</Package>
...
<Package Id="spswfe">
...
</Package>
...
</Configuration>
ARP 元素
指定用來控制產品在 [控制台] 中 [新增或移除程式] 之文字和行為的值。
語法
<ARP attribute**="值"** [attribute**="值"**] ... />
屬性
屬性 |
值 |
描述 |
ARPCOMMENTS |
*文字* |
其他文字；最多 255 個字元，但可能無法顯示所有字元。 |
ARPCONTACT |
*文字* |
技術支援連絡人清單。 |
ARPNOMODIFY |
是 |
讓 [變更] 按鈕無法使用，避免使用者修改產品安裝。 |
否 (預設值) |
允許使用者修改產品安裝。 |
|
ARPNOREMOVE |
是 |
讓 [移除] 按鈕無法使用，避免使用者移除產品。 |
否 (預設值) |
允許使用者移除產品。 |
|
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 |
*毫秒* |
當以設定為 "Full" 或 "Basic" 的 #Element_Display 屬性執行安裝時，這是在執行程式之後，繼續安裝之前所需等候的毫秒數。預設值為 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 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 |
是 |
僅適用於 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 檔案，或當您使用 Setup /config 命令列選項指定 Config.xml 檔案時，安裝程式才會使用 Display 元素。
範例
<Display Level=”basic”
CompletionNotice=”yes”
SupressModal=”no”
AcceptEula=”yes”
/>
INSTALLLOCATION 元素
指定使用者電腦上產品安裝資料夾的完整路徑。
語法
<INSTALLLOCATION Value="路徑" />
屬性
屬性 |
值 |
描述 |
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 = 安裝程式所產生的唯一字串
注意
只有當您使用 Setup /config 命令列選項指定 Config.xml 檔案時，安裝程式才會使用 Logging 元素。若不指定要使用的 Config.xml 檔案，安裝程式會使用預設的記錄選項。
範例
<Logging Type=”standard” Path=”%temp%”
Template=”MyLog(*).txt”
/>
本例中，安裝程式每次安裝產品時都會建立記錄檔。安裝程式使用唯一的檔案名稱，如下所示：
%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt
Package 元素
要安裝的套件或產品。
Office SharePoint Server 2007 的套件識別碼為 spswfe。因為 Office SharePoint Server 2007 係以 Windows SharePoint Services 3.0 的平台技術為基礎，所以您也必須安裝 sts (Windows SharePoint Services 3.0) 套件，否則安裝無法成功。
PIDKEY 元素
25 個字元的大量授權金鑰。
語法
<PIDKEY Value="25個字元的金鑰" />
屬性
屬性 |
值 |
描述 |
Value |
*25 個字元的金鑰* |
25 個字元的大量授權金鑰。 |
備註
設定 PIDKEY 值時，使用者不必在執行安裝程式時輸入產品金鑰。
範例
<PIDKEY Value="1234512345123451234512345" />
注意
若 Display 元素的 Level 屬性設為 "Basic" 或 "None"，而您使用 PIDKEY 元素提供產品金鑰，安裝程式會假設您也代表使用者接受授權合約。在此情況下，無論您如何設定 Display 項目的 AcceptEULA 屬性，安裝期間都不會向使用者提示授權合約。
Setting 元素
可讓您指定 Windows Installer 屬性值。
語法
<Setting Id="名稱" Value="值" />
屬性
屬性 |
值 |
描述 |
Id |
*名稱* |
Windows Installer 屬性的名稱。 |
Value |
*值* |
要指派給屬性的值。 |
值
下列設定識別碼用於伺服器安裝：
識別碼 |
接受的值 |
描述 |
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 版本：標準版 (0) 或企業版 (1)。請注意，所使用的 PIDKEY 會覆寫此項設定。 |
SERVERROLE |
SINGLESERVER、WFE、APPLICATION |
指定安裝目的地之伺服器類型：獨立 (SINGLESERVER)、前端網頁伺服器 (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" />
下載本書
本主題隨附於下列可下載的叢書中，以便於閱讀與列印：
請參閱 Office SharePoint Server 2007 可下載的叢書 (英文) 上提供的完整叢書清單。