Office 2013 的 Config.xml 檔案參考
適用版本： Office 2013
上次修改主題的時間： 2016-12-16
摘要： 提供如何使用 Config.xml 檔案來自訂 Windows Installer 型 Office 2013 安裝的相關資訊。
對象： IT 專業人員
管理員可以使用 Config.xml 檔案來執行 Office 2013 的安裝和維護工作。
管理員在 Office 2013 中自訂 Windows Installer 型產品安裝的主要工具是 Office 自訂工具 (OCT)。Office 2013 中的自訂工具和方法與 Office 2010 和 Office 2007 相同。如需如何使用 OCT 建立安裝程式自訂檔案的詳細資訊，以及了解 Office 2013 中的 OCT 更新，請參閱＜Office 2013 的 Office 自訂工具 (OCT) 參考＞。
使用 Config.xml 檔案來設定安裝工作，並只在執行安裝程式時使用。使用者電腦上不會安裝或快取 Config.xml。管理員可以編輯 Config.xml 檔案以自訂安裝。根據預設，儲存在核心產品資料夾 core_product_folder_name.WW 的 Config.xml 檔案會指示安裝程式安裝該產品。例如，在 ProPlus.WW 資料夾中的 Config.xml 檔案會安裝 Office Professional Plus 2013。
您可以使用 Config.xml 檔案來執行下列安裝工作：
指定網路安裝點的路徑。
選取要安裝的產品。
自訂安裝程式選項，例如，安裝程式自訂檔案和軟體更新的記錄及位置。
設定安裝選項，例如使用者和公司名稱。
將本機安裝來源 (LIS) 複製到使用者電腦，而不安裝 Office。
從安裝新增或移除語言。
您也可以使用 Config.xml 檔案來進行維護作業，例如，新增或移除功能、修復，以及移除安裝。若要執行這項操作，管理員必須再次從原始來源執行 Setup.exe。
.gif "重要事項") 重要事項： |
|---|
| 若要編輯 Config.xml，請使用 [記事本] 等文字編輯器。請勿使用 Word 2013 等一般用途的 XML 編輯器。 |
本文內容：
Config.xml 元素快速參考
安裝程式如何使用 Config.xml
Config.xml 檔案格式
Config.xml 元素參考
範例 Config.xml 檔案
Config.xml 元素快速參考
下表列出 Config.xml 元素。這些元素可依任何順序顯示，但 Configuration 元素 元素必須先顯示，至於 Command 元素 等元素在 Config.xml 中的順序，則會影響其在安裝期間的處理方式。
Config.xml 快速參考
| 元素 | 描述 |
|---|---|
設定 |
頂層元素 |
AddLanguage 元素 |
將語言新增至安裝 |
ARP 元素 |
控制 [控制台] 中 [程式和功能] 選項之文字和行為的值，可新增或移除產品的功能 |
Command 元素 |
在安裝期間執行命令 |
COMPANYNAME 元素 |
安裝產品之電腦使用者的組織或公司名稱 |
Display 元素 |
安裝程式向使用者顯示的 UI 層級 |
DistributionPoint 元素 |
要執行安裝的網路安裝點完整路徑 |
INSTALLLOCATION 元素 |
使用者電腦上產品安裝資料夾的完整路徑 |
LIS 元素 |
如何在使用者的電腦上快取本機安裝來源 (LIS) 的選項 |
Logging 元素 |
安裝程式執行的記錄類型選項 |
OptionState 元素 |
指定安裝期間處理個別產品功能的選項 |
PIDKEY 元素 |
25 個字元的大量授權金鑰 |
RemoveLanguage 元素 |
從安裝移除語言 |
Setting 元素 |
Windows Installer 屬性的值 |
SetupUpdates 元素 |
安裝程式用來尋找安裝程式自訂檔案的搜尋路徑 |
USERINITIALS 元素 |
安裝產品之電腦使用者的簡稱 |
USERNAME 元素 |
安裝產品之電腦使用者的名稱 |
安裝程式如何使用 Config.xml
安裝程式會在 Setup.exe 所在的資料夾中尋找 Config.xml 的複本。如果在此找不到複本，安裝程式會使用位於您安裝產品之核心產品資料夾中的 Config.xml 檔案 (如果網路安裝點有多項產品，安裝程式會等您指定要安裝的產品之後，再尋找 Config.xml 的複本)。位於產品資料夾的 Config.xml 的複本會透過 Configuration 元素 的 Product 屬性識別產品。
您也可以使用 /config 安裝程式命令列選項，以指定 Config.xml 檔案的位置。例如：
\\ server \ share \setup.exe /config \\ server \ share \ProPlus.WW\config.xml
.gif "注意事項") 附註： |
|---|
| 如果同時使用 OCT 建立安裝程式自訂 (.msp) 檔案，則 Config.xml 中定義的自訂，會優先於自訂檔案中的自訂。 |
Config.xml 檔案格式
Config.xml 中的 XML 元素會以 < 開頭，以 /> 結尾。
基本元素格式如下：
< element [attribute**="value"] [attribute="value"**] … />
例如：
<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />
其格式陳述如下：
元素與屬性是區分大小寫的。
屬性值必須以引號 (") 括住，但不區分大小寫。
元素定義可以跨多行。元素定義中的空格、換行字元、換列字元及定位字元將會忽略。
以下是跨多行之元素定義的範例。
<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />
.gif "提示") 提示： |
|---|
| 對於較長的元素定義，請將各屬性自成一行並加以縮排，以便於檔案的閱讀。 |
Configuration 元素 是特殊情況，而且是必要元素。所有其他元素都是包含在 Configuration 元素 中，且此元素是以 </Configuration> 結尾，如下列範例所示。
<Configuration Product="ProPlus">
<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
<!-- <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" /> -->
<!-- <USERNAME Value="Customer" /> -->
<!-- <COMPANYNAME Value="MyCompany" /> -->
<!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->
<!-- <LIS CACHEACTION="CacheOnly" /> -->
<!-- <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->
<!-- <DistributionPoint Location="\\server\share\Office" /> -->
<!-- <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>
您可在任何位置新增註解，並利用 "<!--" 及 "-->" 加以區隔。
例如：
<!-- Configure install options for Microsoft Office Professional Plus 2010 -->
<Configuration Product="ProPlus" >
<Display
<!-- Turn off all Setup UI and prevent prompting users-->
Level="none"
CompletionNotice="no"
SuppressModal="yes"
<!-- Accept the EULA for the user -->
AcceptEula="Yes"
/>
</Configuration>
每個 Office 產品資料夾均包含預設的 Config.xml 檔案，其中的 Configuration 元素 已將 Product 屬性設為適合產品的值。Configuration 元素 包含以註解括住的一些範例元素。若要啟用這些元素，請移除開頭和結尾的註解記號，然後輸入適當的屬性值。
如下列範例所示，您可以啟用 Display 元素，方法是將這一行：
<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
變更為這一行：
<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />
上一個範例中的 Display 選項會導引安裝程式執行無訊息安裝，而不會出現提示讓使用者輸入資訊，且安裝作業不需要等待使用者的互動回應。
Config.xml 元素參考
此參考中的說明使用下列慣例。
格式慣例
bold |
元素或屬性名稱 |
標準 |
要輸入的實際顯示文字 |
italic |
要新增之值的預留位置 |
x|y |
從多個值中選擇 |
[x] |
選用值 |
Configuration 元素
頂層元素。此元素為必要元素，且所有其他元素都必須出現在此元素中。
語法
<Configuration [Product="productID"] >
...
</Configuration>
屬性
下表說明 Configuration 元素屬性及值。
Configuration 元素屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Product |
productID |
已安裝產品在 Setup.xml 檔案之 Setup 元素中的 ID 屬性值。 |
備註
Product 屬性識別此 Config.xml 檔案影響的產品。productID會在 Setup.xml 檔案之 Setup 元素的 ID 屬性中定義，該檔案位於產品的核心資料夾中。
Product 屬性為選用，除非您將 Display 元素Level 屬性設為 “basic” 或 “none”。在此情況下，Product 屬性為必要。如果網路安裝點中未存有 Product 屬性指定的產品，安裝程式會結束安裝。
範例
Office Professional Plus 2013 的productID在 ProPlus.WW\Setup.xml 中位於下行中：
<Setup Id="ProPlus" Type="Product" ... >
您可以輸入下列字行，即能在 Config.xml 中使用此productID來指定 Office Professional Plus 2013：
<Configuration Product="ProPlus">
...
</Configuration>
AddLanguage 元素
將指定語言新增至安裝。
語法
<AddLanguage
Id=" ll-cc " | "match"
[ShellTransform="Yes"]
/>
屬性
下表說明 AddLanguage 元素屬性及值。
AddLanguage 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Id |
ll - cc |
語言識別碼。 |
match |
比對使用者之 Windows 使用者地區設定的語言 Id。 |
|
ShellTransform |
Yes |
指定殼層使用者介面的語言。如果指定了多個 AddLanguage 元素，只有一個語言必須指定 ShellTransform 元素。 |
備註
網路安裝點必須具有此語言。
AddLanguage 和 RemoveLanguage 元素 可以有多個元素。如果 RemoveLanguage 元素 和 AddLanguage 元素指定相同語言，則以 AddLanguage 元素為優先並安裝該語言。
| 附註： |
|---|
| 如果指定了多個 AddLanguage 元素，只有一個語言必須指定 ShellTransform 元素，否則安裝程式會結束安裝。 |
安裝 Office 2013 時，您應該了解三個語言概念：
安裝程式使用者介面 (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 圖像，您可以在 Config.xml 檔案中新增下列元素，指定安裝程式安裝這些語言的完整語言支援，並將殼層 UI 設定為遵循使用者的預設區域選項。
<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 attribute =" value " [attribute**="value"**] ... />
屬性
下表說明 ARP 元素屬性及值。
ARP 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
ARPCOMMENTS |
text |
其他文字。最多可以有 255 個字元，不過可能不會顯示所有字元。 |
ARPCONTACT |
text |
技術支援連絡人清單。 |
ARPNOMODIFY |
Yes |
將 [變更] 按鈕設定為無法使用，以防止使用者變更產品安裝。 |
No (預設) |
允許使用者修改產品安裝。 |
|
ARPNOREMOVE |
Yes |
將 [移除] 按鈕設定為無法使用，以防止使用者移除產品。 |
No (預設) |
允許使用者移除產品。 |
|
ARPURLINFOABOUT |
URL |
產品首頁 URL。 |
ARPURLUPDATEINFO |
URL |
產品更新資訊 URL。 |
ARPHELPLINK |
URL |
使用者可以取得技術支援的網站 URL。 |
ARPHELPTELEPHONE |
text |
技術支援的電話號碼。 |
Command 元素
指定要執行的命令列。如需詳細資訊，請參閱本文稍後的＜註解＞。
| 提示： |
|---|
| 在 OCT 中的對等選項是＜新增安裝並執行程式＞。 |
語法
<Command
Path=" path "
[QuietArg="arguments"]
[Args="args"]
[ChainPosition="Before" | "After"(預設)]
[Wait="mseconds"]
[Execute="Install"(預設) | "Uninstall"]
[Platform="x86"(預設) | "x64"]
/>
屬性
下表說明 Command 元素屬性。
Command 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Path |
path |
可執行檔的完整路徑。如果路徑值包含空格，您必須使用雙引號，如下列範例所示： "\\server\share\Office 14\copylogs.bat" |
QuietArg |
string |
設定無訊息安裝時，附加至命令列的引數字串。如需何時使用 QuietArg 屬性的詳細資訊，請參閱此表格下方的＜註解＞一節。 |
Args |
string |
要傳送至可執行檔的引數字串。如需何時使用 Args 屬性進行鏈結安裝的資訊，請參閱此表格下方的＜註解＞一節。 如果 Args 元素的值包含問號，您可以使用單引號 (') 括住整個值，如下列範例所示： Args='"/param value"' |
ChainPosition |
Before |
此命令會在安裝主要產品之前執行。 |
After (預設) |
此命令會在安裝主要產品之後執行。 |
|
Wait |
mseconds |
當您安裝產品並將 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 中的 [新增安裝並執行程式]，只執行不會變更電腦或不需要使用者輸入的輕量型可執行檔或任意命令。例如，您可以執行公用程式複製記錄檔或命令，在安裝作業結束時啟動「歡迎」頁面。
| 重要事項： |
|---|
| 鏈結不像分別安裝每項產品那樣穩定。例如，若將兩項安裝鏈結在一起，但其中一個產品失敗或發生未預期的錯誤，則主要安裝及鏈結安裝可能無法成功完成。因此，建議您不要使用鏈結方法。在企業環境中同時安裝多種產品的建議方法不是鏈結，是使用部署管理程式 (如 Microsoft System Center 2012 Configuration Manager 或 Microsoft Systems Management Server (SMS) 2003) 或協力廠商工具。 |
Args 和 QuietArg 的使用方式如下：
Args 屬性一律會附加至命令，可包含 "/install" 或 **"Company=**MyCorporation" 等參數。
如果以無訊息方式執行安裝程式，也會附加 QuietArg 屬性 (將 Display 設為 Display="none")。在此情況下，您可以使用 "/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 元素
安裝產品之電腦使用者的組織或公司名稱。
| 提示： |
|---|
| 在 OCT 中的對等選項是＜安裝位置和組織名稱＞中的 [組織名稱] 設定。 |
語法
<COMPANYNAME Value=" companyname " />
屬性
下表說明 COMPANYNAME 元素屬性及值。
COMPANYNAME 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Value |
companyname |
公司或組織名稱。 |
範例
<COMPANYNAME Value="Microsoft Corporation" />
Display 元素
安裝程式向使用者顯示的 UI 層級。
| 提示： |
|---|
| 在 OCT 中的對等選項是＜Office 2013 的 Office 自訂工具 (OCT) 參考＞之＜授權及使用者介面＞中的 [顯示層級] 及授權合約設定。 |
語法
<Display
Level="None" | "Basic" | "Full"(預設)
CompletionNotice="Yes" | "No"(預設)
SuppressModal="Yes" | "No"(預設)
NoCancel="Yes" | "No"(預設)
AcceptEula="Yes" | "No"(預設)
/>
屬性
下表說明 Display 元素屬性及值。
Display 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Level |
None |
不會顯示安裝程式 UI。如果設定 Display Level="none"，安裝程式會執行無訊息 (自動) 安裝。如需詳細資訊，請參閱＜註解＞一節。 |
Basic |
安裝程式會顯示 [歡迎] 畫面、產品金鑰 (PIDKEY) 頁面 (如果需要)、軟體授權合約頁面 (如果需要)、進度列，以及完成通知 (如果允許)。 |
|
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 軟體授權合約。安裝程式不會顯示軟體授權合約頁面。 |
No (預設) |
如果 Level 未設為 ”none”，安裝程式會顯示軟體授權合約頁面。 |
備註
如果未定義此元素，則會使用預設設定。如果指定的值無效，安裝程式會結束安裝。
如果 Level 屬性設為 "basic" 或 “none”，且您使用 PIDKEY 元素 提供產品金鑰，安裝程式假設您也會代表使用者接受授權合約。
| 附註： |
|---|
| 在企業部署中，建議您將 Display Level 值設為 “none”，以告知安裝程式執行無訊息安裝。如此即不會提示使用者輸入資訊，並讓安裝免於等待與使用者互動 (包括檔案正在使用時)。將 Display Level 值設為“none” 時，會假設 SuppressModal 和 CompletionNotice 屬性均已設定為無訊息模式，而且已接受 Microsoft 軟體授權合約。管理員也必須確認在安裝 Office 2013 期間，未執行任何 Office 應用程式。 如果將 Display Level 值設為 “basic”，並將 SuppressModal 設為 “yes”，只要有任何 Office 檔案正在使用中，就可能會提示使用者。將 Display Level 設為 “none” 可防止在這些情況下提示使用者。SuppressModal 屬性不會阻止顯示files in use的訊息。唯有將 Display Level 設為 “none”，才能阻止顯示files in use的訊息。 僅在安裝程式於 setup.exe 所在的資料夾中找到 Config.xml 檔案時，或您使用安裝程式 /config 命令列選項指定 Config.xml 檔案時，才可以使用 Display 元素。如果安裝程式使用產品資料夾中的 Config.xml 檔案，安裝程式會使用預設顯示選項。 |
範例
<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="Yes" />
DistributionPoint 元素
指定要執行安裝的網路安裝點完整路徑。
語法
<DistributionPoint Location=" path " />
屬性
下表說明 DistributionPoint 元素屬性及值。
DistributionPoint 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Location |
path |
要執行安裝的網路安裝點之完整路徑。 |
備註
如果未指定此元素，安裝程式會假設 Setup.exe 檔案位於網路安裝點的根目錄。
| 附註： |
|---|
| 僅在安裝程式於 setup.exe 所在的資料夾中找到 Config.xml 檔案時，或您使用安裝程式 /config 命令列選項指定 Config.xml 檔案時，才可以使用 DistributionPoint 元素。如果安裝程式使用產品資料夾中的 Config.xml 檔案，由於已找到網路安裝點，因此會忽略此元素。 |
範例
<DistributionPoint Location="\\server1\office" />
INSTALLLOCATION 元素
指定使用者電腦上產品安裝資料夾的完整路徑。
| 提示： |
|---|
| 在 OCT 中的對等選項是＜安裝位置和組織名稱＞中的 [預設安裝路徑] 設定。 |
語法
<INSTALLLOCATION Value=" path " />
屬性
下表說明 INSTALLLOCATION 元素屬性及值。
INSTALLLOCATION 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Value |
path |
使用者電腦上產品安裝資料夾的完整路徑。 |
備註
您可以在路徑中使用系統環境變數。如果未指定此元素，Office 會安裝在 %ProgramFiles%\Microsoft Office 中。
範例
<INSTALLLOCATION Value="%ProgramFiles%\MyApps" />
LIS 元素
控制如何在使用者的電腦上快取本機安裝來源 (LIS)，並指定包含產品安裝檔案的一或多個網路安裝點位置。
語法
<LIS
[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]
[SOURCELIST=" semicolon-delimited-path-list "]
/>
屬性
下表說明 LIS 元素屬性及值。
LIS 屬性
| 屬性 | 值 | 描述 | ||
|---|---|---|---|---|
CACHEACTION |
CacheOnly |
安裝程式會將 LIS 複製到使用者的電腦，但是不會安裝產品。
|
||
RemoveCacheOnly |
如果將快取複製到使用者的電腦且未安裝 Office，安裝程式會從使用者的電腦中移除 LIS，但是不會安裝或解除安裝產品。 |
|||
SOURCELIST |
semicolon-delimited-path-list |
包含產品安裝檔案的一或多個網路安裝點清單 (以分號分隔)。 在 OCT 中的對等選項是＜其他網路來源＞。 |
備註
預設會在安裝 Office 的磁碟機根目錄之 \MsoCache\All Users 資料夾中建立 LIS。此外，也會複製網路安裝點之 Updates 資料夾中的安裝程式自訂檔案和軟體更新。
如果指定 INSTALLLOCATION 元素，會以路徑中指定的磁碟機來決定建立 LIS 所在的磁碟機。例如，若 INSTALLLOCATION 元素 路徑為 E:\office\files，LIS 會建立在磁碟機 E 上。SOURCELIST 屬性所列出的來源會隨已安裝的產品保留，並在使用者電腦上的 LIS 遺失或損毀時，供安裝程式使用。
範例
<LIS CACHEACTION="CacheOnly" />
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />
Logging 元素
指定安裝程式執行的記錄類型。
語法
<Logging
Type="Off" | "Standard"(預設) | "Verbose"
Path=" path "
Template=" filename .txt"
/>
屬性
下表說明 Logging 元素屬性及值。
Logging 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Type |
Off |
安裝程式不會執行記錄。 |
Standard (預設) |
安裝程式會將安裝資訊寫入記錄檔。 |
|
Verbose |
安裝程式會將所有安裝資訊寫入記錄檔。 |
|
Path |
path |
用於記錄檔的資料夾之完整路徑。您可以使用環境變數。預設值為 %temp%。 |
Template |
filename .txt |
記錄檔的名稱。如果在檔案名稱的任何位置插入字串 *，系統會為 setup.exe 執行的每個安裝建立唯一的記錄檔 (請參閱本文稍後的說明)。如果未包含 * 字元，且已存在指定的檔案名稱，則會在現有的檔案附加記錄資訊。必須包含 .txt 副檔名。預設範本為 SetupExe(*).log。 |
備註
您可以在 Template 值中的任何位置指定 *。安裝程式會在該位置插入使用下列格式的字串。
YYYYMMDDHHMMSS xxx
其中：
YYYY = 年
MM = 月
DD = 日
HH = 時
MM = 分
SS = 秒
xxx = 安裝程式產生的唯一字串
| 附註： |
|---|
| 僅在安裝程式於 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
OptionState 元素
指定在安裝期間如何處理特定的產品功能。
| 重要事項： |
|---|
| 在大多數情況下，建議您使用 OCT 來變更功能的安裝狀態。在 OCT 中的對等選項是＜設定功能安裝狀態＞。 |
語法
<OptionState
Id="optionID"
State="Absent" | "Advertise" | "Local"
[Children="force"]
/>
屬性
下表說明 OptionState 元素屬性及值。
OptionState 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Id |
optionID |
使用者可以選擇要安裝的項目。 |
State |
Absent |
未安裝此功能。 |
Advertise |
此功能會在第一次使用時安裝。 |
|
Local |
此功能是安裝在使用者的電腦上。 |
|
Children |
force |
此功能的所有子功能都設定為指定的狀態。 |
備註
功能是使用者可以選擇要安裝的項目。功能的 Id 值會在核心產品資料夾之 Setup.xml 檔案的 Option 元素中定義。
| 附註： |
|---|
在 Office 2013 的安裝程式功能安裝狀態樹狀目錄中，不會出現 Publisher 2013 的下列子元件。
|
範例
<OptionState Id="ExcelAddinFiles"
State="Absent"
Children="force"
/>
PIDKEY 元素
25 個字元的大量授權金鑰。
| 附註： |
|---|
| 在 OCT 中的對等選項是＜Office 2013 的 Office 自訂工具 (OCT) 參考＞之＜授權及使用者介面＞中的 [產品金鑰] 設定。如需 Office Professional 2013 大量授權的詳細資訊，請參閱＜規劃 Office 2013 的大量啟用＞。 凡採用金鑰管理服務 (KMS) 啟用方式進行企業部署者，不需要輸入產品金鑰，因為所有大量授權版本的 Office 2013 都已預先安裝 KMS 用戶端金鑰。KMS 是 Office 啟用技術所提供，是啟用 Microsoft 大量授權方案授權之產品的方法之一。KMS 會使用 KMS 主機金鑰來啟用 KMS 主機電腦，並在您的環境中建立本機啟用服務。Office 2013 會連至本機 KMS 主機以進行啟用。在 OCT 中 ([授權及使用者介面] 區段中)，預設會選取 [使用 KMS 用戶端金鑰] 選項。 「多重啟用金鑰」(MAK) 金鑰是 Office 啟用技術所提供，是啟用 Microsoft 大量授權方案授權之產品的方法之一。藉由 MAK，用戶端就能利用 Microsoft 託管的啟用伺服器或透過電話，從線上啟用 Office 2013。管理員可以使用 Config.xml 檔案來輸入 MAK 金鑰。如需如何新增 MAK 金鑰的詳細資訊，請參閱＜註解＞一節。 KMS 啟用會啟用連接至 KMS 主機的所有 Office 大量授權用戶端，而 Active Directory 型啟用也是類似的情況，它會啟用 Active Directory 網域中的所有 Office 大量授權用戶端。如需 Active Directory 型啟用的詳細資訊，請參閱＜Active Directory 型啟用概觀＞。如需大量啟用的詳細資訊，請參閱＜規劃 Office 2013 的大量啟用＞。 |
| 重要事項： |
|---|
| 此資訊僅適用於 Office 2013 的大量授權版本。不適用於須透過訂閱取得授權的 Office 365 專業增強版。 |
語法
<PIDKEY Value=" 25-character-key " />
屬性
下表說明 PIDKEY 元素屬性及值。
PIDKEY 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Value |
25-character-key |
25 個字元的大量授權金鑰。 |
備註
設定 PIDKEY 值之後，使用者在安裝 Office 時不需要輸入產品金鑰。
若要在 Config.xml 檔案中輸入 MAK 金鑰，請將下行新增至檔案。
<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />
其中的 AAAAABBBBBCCCCCDDDDDEEEEE 是 25 個字元的產品金鑰。如需 Office 2013 授權的詳細資訊，請參閱＜Office 2013 的大量啟用＞。
範例
<PIDKEY Value="1234512345123451234512345" />
| 附註： |
|---|
| 如果 Display 元素 的 Level 屬性設為 "basic" 或 "none"，且您使用 PIDKEY 元素提供產品金鑰，安裝程式假設您也會代表使用者接受授權合約。在此情況下，不論您如何設定 Display 元素 的 AcceptEULA 屬性，系統都不會在安裝期間或第一次執行 Office 應用程式時提示使用者輸入授權合約。 |
RemoveLanguage 元素
從安裝中移除指定的語言。
語法
<RemoveLanguage Id=" ll - cc " />
屬性
下表說明 RemoveLanguage 元素屬性及值。
RemoveLanguage 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Id |
ll-cc |
語言識別碼。 |
備註
如果使用者的電腦上未安裝此語言，則會忽略 RemoveLanguage 元素。
AddLanguage 元素 和 RemoveLanguage 可以有多個元素。如果 RemoveLanguage 和 AddLanguage 元素 元素指定相同語言，則以 AddLanguage 元素 元素為優先並安裝該語言。
範例
<RemoveLanguage Id="en-us" />
Setting 元素
可讓您指定 Windows Installer 屬性的值。
| 提示： |
|---|
| 在 OCT 中的對等選項是＜Office 2013 的 Office 自訂工具 (OCT) 參考＞中的＜修改安裝程式內容＞。 |
語法
<Setting Id=" name " Value=" value " />
屬性
下表說明 Setting 元素屬性及值。
Setting 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Id |
name |
Windows Installer 屬性的名稱。 |
Value |
value |
指派給屬性的值。 |
備註
並非所有 Windows Installer 屬性都可以在 Setting 元素中指定。如果指定了封鎖的屬性，安裝程式會結束安裝程序。如果指定了支援的屬性，安裝程式會將屬性直接傳給 Windows Installer。
Setting 元素支援下列金鑰管理系統 (KMS) 屬性：
KMSSERVICENAME — 指定 KMS 主機名稱。
KMSSERVICEPORT — 指定 KMS 主機連接埠。
例如，若要使用 KMS 屬性，請使用下列語法：
<Setting Id="KMSSERVICENAME" Value="contoso.com" />
<Setting Id="KMSSERVICEPORT" Value="1234" />
其中：
contoso.com 是 KMS 主機名稱
1234 是連接埠號碼值
| 附註： |
|---|
| 指定 KMSSERVICENAME 和 KMSSERVICEPORT 值的建議工具是 Office 軟體保護平台指令碼 (ospp.vbs)。若要使用 ospp.vbs 設定 KMS 主機名稱和連接埠值，請執行下列命令： ospp.vbs /sethst:value ospp.vbs /setprt:value 在上一個範例中，sethst value是 KMS 主機名稱，而 setprt value是 KMS 主機連接埠。 或者，您也可以在 Config.xml 檔案中設定 KMS 屬性。例如，在執行 64 位元版的 Windows 電腦上安裝 32 位元 Office 2013 的情況。如需大量啟用的資訊，請參閱＜規劃 Office 2013 的大量啟用＞。 |
Setting 元素支援產品金鑰啟用的 AUTO_ACTIVATE 屬性。此屬性指定在 Office 2013 部署期間自動啟用產品，並使用下列語法。
<Setting Id="AUTO_ACTIVATE" Value="1" />
| 附註： |
|---|
| 不設定 AUTO_ACTIVATE 等同於將 AUTO_ACTIVATE 的value設為 0。最後，在 Office 2013 部署期間就不會啟用產品。 請注意，您也可以使用 Office 自訂工具設定 AUTO_ACTIVATE 屬性值。若要執行這項操作，請遵循下列步驟：
|
Setting 元素支援 REMOVEPREVIOUS 屬性。此屬性會從安裝中移除指定的應用程式，並使用下列語法。
<Setting Id="REMOVEPREVIOUS" Value="Option Id" />
其中Option Id是 Office 2013 應用程式的識別碼值。若要指定多個應用程式，請使用逗號分隔清單，表示適當的Option Id值。
| 附註： |
|---|
| 如果您安裝 Outlook，不論使用者的喜好設定為何，一律會移除先前安裝的 Outlook 版本。 |
如果用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 元素
指定安裝程式用來尋找安裝程式自訂檔案的搜尋路徑。
語法
<SetupUpdates
[CheckForSUpdates="Yes"(預設) | "No"]
[SUpdateLocation="path-list"]
/>
屬性
下表說明 SetupUpdates 元素屬性及值。
SetupUpdates 屬性
| 屬性 | 值 | 描述 | ||
|---|---|---|---|---|
CheckForSUpdates |
Yes (預設) |
安裝程式使用 SUpdateLocation 中的路徑清單來尋找安裝程式自訂檔案。 |
||
No |
安裝程式不會使用 SUpdateLocation 中的路徑清單來搜尋安裝程式自訂檔案。 |
|||
SUpdateLocation |
path-list |
資料夾的完整路徑清單 (以分號分隔)。
|
備註
安裝程式會在所有指定的資料夾中，尋找為正在安裝之產品建立的安裝程式自訂檔案，並按照檔案名稱的字母順序套用。如果安裝程式命令列中指定了安裝程式自訂檔案，則會先套用該檔案，接著再套用此元素指定之資料夾中找到的任何檔案。
範例
<SetupUpdates
CheckForSUpdates="Yes"
SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>
USERINITIALS 元素
安裝產品之電腦使用者的簡稱。
語法
<USERINITIALS Value=" value " />
屬性
下表說明 USERINITIALS 元素屬性及值。
USERINITIALS 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Value |
value |
使用者的簡稱 |
範例
<USERINITIALS Value="JD" />
USERNAME 元素
安裝產品之電腦使用者的名稱。
語法
<USERNAME Value=" value " />
屬性
下表說明 USERNAME 元素屬性及值。
USERNAME 屬性
| 屬性 | 值 | 描述 |
|---|---|---|
Value |
value |
使用者的名稱。 |
備註
Office 2013 Username 元素資料會如下填入。
如果執行 Office 的使用者與安裝 Office 使用者相同，則會使用安裝期間提供的 Username 和 Initials。第一次啟動 Office 時，「不會」提示使用者。自行安裝 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" />
範例 Config.xml 檔案
下列範例為適用於一般安裝的 Config.xml 檔案。該範例使用 Office Professional Plus 2013 版本的產品。
<Configuration Product="ProPlus">
<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
<!-- <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" /> -->
<!-- <USERNAME Value="Customer" /> -->
<!-- <COMPANYNAME Value="MyCompany" /> -->
<!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->
<!-- <LIS CACHEACTION="CacheOnly" /> -->
<!-- <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->
<!-- <DistributionPoint Location="\\server\share\Office" /> -->
<!-- <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>