摘要：提供 Click-to-Run for Office 365 產品之 Configuration.xml 檔案的相關資訊。
適用於： Office 365 ProPlus
對象：IT 專業人員
隨選即用 Office 365 Configuration.xml 檔案用來指定 隨選即用安裝及更新選項。 Office 部署工具是可下載的工具，包含一個 Configuration.xml 範例檔。系統管理員可以修改 Configuration.xml 檔案來設定 隨選即用 Office 365 產品的安裝選項。
隨選即用 Configuration.xml 檔案是 Office 部署工具的必要元件。隨選即用 的自訂方法主要是先啟動 Office 部署工具，然後提供自訂的 Configuration.xml 檔案。Office 部署工具會執行使用設定檔中的選用屬性所指定的工作。 若是 Office 2013 版的產品，系統管理員可以從 Microsoft 下載中心下載 Office 部署工具。
您可以使用隨選即用 Configuration.xml 檔案，執行下列工作：
-
從安裝新增或移除產品
-
從安裝新增或移除語言
-
指定顯示選項
-
設定記錄選項
-
指定隨選即用的軟體更新行為
.gif) 重要事項： |
|---|
| 本文是 跟部署 Office 365 ProPlus 有關的內容藍圖的一部分，適用於 IT 專業人員。以藍圖做為起點來取得文章，以協助您在組織中部署 Office 365 ProPlus。 您在尋找安裝 Office 與 Office 365 的協助嗎？您可以尋找＜ 開始使用 Office 365 ＞和＜ 安裝 Office 與 Office 365＞，協助您了解如何在電腦、手機及平板電腦上設定和使用 Office 365。 |
本文內容：
-
隨選即用 Configuration.xml 快速參考
-
隨選即用 Configuration.xml 檔案格式
-
隨選即用 Configuration.xml 參考
-
隨選即用 Configuration.xml 範例
.gif) 附註： |
|---|
| 您不能自訂 隨選即用 Office 365產品的安裝位置。隨選即用只能部署至系統磁碟機，通常為 C 槽。 無法在應用程式層級自訂隨選即用。但是，有一些選項可供選擇：
|
如需隨選即用已知問題的最新資訊，請參閱 office.com 網站上的 Office 已知問題。
隨選即用 Configuration.xml 快速參考
下表列出隨選即用 Configuration.xml 元素。
Configuration.xml 參照
| 元素 | 描述 |
|---|---|
| Configuration 元素 | 頂層元素 |
| Add 元素 | 指定要安裝的產品和語言 |
| Display 元素 | 安裝程式向使用者顯示的 UI 層級 |
| Language 元素 | Product 子元素。新增語言至安裝 |
| Logging 元素 | 指定安裝程式執行之記錄類型的選項 |
| Product 元素 | Add 或 Remove 子元素。指定要安裝的產品 |
| Property 元素 | 適用於一般屬性。 |
| Remove 元素 | 指定要移除的產品和語言 |
| Updates 元素 | 指定 Office 檢查及取得產品更新的方式 |
隨選即用 Configuration.xml 檔案格式
隨選即用 Configuration.xml 中的 XML 元素以 < 開頭，以 /> 結束。
基本元素格式如下：
< element [attribute="value"] [attribute="value"] … />
下列範例在產品完成安裝並代表使用者接受授權合約時，不會顯示任何使用者介面：
<Display Level="None" AcceptEULA="TRUE" />隨選即用 Configuration.xml 參考
下表列出此參考中使用的慣例。
格式慣例
| 格式 | 描述 |
|---|---|
| 粗體 | 元素或屬性名稱 |
| 標準 | 依顯示輸入文字 |
| 斜體 | 值的預留位置 |
| X | Y | 選擇值 |
| {x} | 選用值 |
Configuration 元素
頂層元素。此元素為必要元素，且所有其他元素都必須出現在此元素中。
語法
<Configuration>
{0 或 1 Add 元素}
{0 或 1 Remove 元素}
{0 或 1 Updates 元素}
{0 或 1 Display 元素}
{0 或 1 Logging 元素}
</Configuration>
Add 元素
指定要安裝的產品和語言。
語法
<Add
SourcePath="\\server\share\"
Version="15.1.2.3"
ForceDowngrade= TRUE | FALSE
OfficeClientEdition=32 | 64
>
{0 或 N Product 元素}
</Add>
下表說明 Add 元素屬性及值。
Add 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| SourcePath | \\server\share\ C:\Preload\Office http://internalApps/Office/ | 選用。 SourcePath 值可設為包含隨選即用來源的網路、本機或 HTTP 路徑。環境變數可用於網路或本機路徑。
SourcePath 指出當您在 download 模式中執行 Office 部署工具時，要將隨選即用安裝來源儲存到的位置。
SourcePath 會指出當您在 configure 模式中執行 Office 部署工具 時，從中安裝 Office 的安裝來源路徑。如果您在 configure 模式中未指定 SourcePath，則安裝程式將會查看目前資料夾中是否有 Office 來源檔案。如果在目前資料夾中找不到 Office 來源檔案，則安裝程式將會查看 Office 365 中是否有這些檔案。
當您在 packager 模式中執行 Office 部署工具時，SourcePath 指定用來建立 App-V 封裝之 隨選即用 Office 來源的路徑。 如果您未指定 SourcePath，則安裝程式會嘗試在您執行 setup.exe 的工作目錄中建立 \Office\Data\... 資料夾結構。 |
| Version | 15.1.2.3 | 選用。如果未設定 Version 值，隨選即用 產品安裝會從來源中串流傳送最新可用的版本。預設是使用最新公告的組建 (在 隨選即用 Office 安裝來源的 v32.CAB 或 v64.CAB 中定義)。 Version 可設為 Office 2013 組建編號 (使用此格式：X.X.X.X) |
| ForceDowngrade | TRUE 或 FALSE | 選用。如果未設定 ForceDowngrade，則會將其解譯為 FALSE。 當您新增產品時，新檔案必須比已安裝在用戶端上的檔案新，才會下載該檔案。 如果 ForceDowngrade 設為 TRUE，而且有指定 Version 屬性，則所下載的產品將會下載指定版本的所有產品檔案，即使安裝在用戶端上的檔案較新也一樣。 |
| OfficeClientEdition | 32 或 64 | 必要。指定要使用的 隨選即用 for Office 365 產品版本：32 位元或 64 位元。如果 OfficeClientEdition 未設為有效值，動作會失敗。 如果 OfficeClientEdition 設定不正確，configure 模式動作可能會失敗。例如，嘗試在執行 32 位元 Windows 作業系統的電腦上安裝 64 位元版本的 隨選即用 for Office 365 產品，或嘗試在已安裝 64 位元版本 Office 的電腦上安裝 32 位元 隨選即用 for Office 365 產品。 |
|
附註： |
|---|
| Product 元素會指定所要安裝的產品，也會指定語言 (以 {1 或 N Language 元素} 指定)。請參閱＜Language 元素＞。 |
下列範例中的程式碼會從指定的 \\server\share 網路共用位置安裝英文版的 Office 365 ProPlus 32 位元 15.1.2.3 版。
<Add SourcePath="\\server\share\" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail>
<Language ID="en-us" />
</Product>
</Add>Display 元素
指定要對使用者顯示的使用者介面層級。
語法
<Display
Level=None | Full
AcceptEULA=TRUE | FALSE
/>
下表說明 Display 元素屬性及值。
Display 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| 層級 | 無 Full | 選用。決定執行作業時為使用者顯示的使用者介面。 如果 Level 設為 None，使用者就不會看到 UI。將不會顯示任何進度 UI、完成畫面、錯誤對話方塊，或初次執行自動啟動 UI。 如果 Level 設為 Full，使用者會看到正常的隨選即用使用者介面：自動啟動、應用程式啟動顯示畫面及錯誤對話方塊。 |
| AcceptEULA | TRUE FALSE | 選用。建議管理員將 AcceptEULA 設為 TRUE。 如果此屬性設為 TRUE，使用者就不會看到 [Microsoft 軟體授權合約] 對話方塊。 如果此屬性設為 FALSE 或未設定，使用者就會看到 [Microsoft 軟體授權合約] 對話方塊。 |
範例：
<Display Level="None" AcceptEULA="TRUE" />
Language 元素
指定所要安裝的語言。
語法
<Language ID= "ll-cc" />
下表說明 Language 元素屬性及值。
Language 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| ID | ll-cc | 必要。如果未設定 Language ID 值，安裝作業會失敗，並會指出該輸入無效。 ID 值可設為有效的 Office 文化語言 (例如 en-us 代表美國英文，ja-jp 代表日文)。ll-cc 值是語言識別碼。 |
如需語言識別碼 (語言標記) 的詳細資訊，請參閱＜ 語言識別碼＞。
|
附註： |
|---|
| Language 元素可決定所要安裝的產品語言。管理員必須指定所要安裝的語言。第一個語言決定 Shell UI 文化。Shell UI 會是捷徑、右鍵捷徑功能表及工具提示的語言。 如果您在初始安裝之後決定變更 Shell UI 語言，您必須解除安裝 隨選即用 後再重新安裝。在自訂 Configuration.xml 檔案中，將要為 Shell UI 設定的語言新增為第一個語言。 |
下列範例示範如何安裝英文、日文及西班牙文版本的 Office 365 ProPlus 32 位元版。
<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
</Product>
</Add>
Logging 元素
指定隨選即用執行的記錄類型。
語法
<Logging
Level =Off | Standard
Path =UNC 或本機路徑
Name =有效的檔案名稱
/>
下表說明 Logging 元素屬性及值。
Logging 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| 層級 | Off Standard | 選用。指定隨選即用安裝程式執行的記錄選項。預設層級為 Standard。 |
| Path | %temp%\\server\share\userlogs\ | 選用。指定用於記錄檔的資料夾完整路徑。您可以使用環境變數。預設值為 %temp%。 |
| 名稱 | 選用。指定記錄檔的名稱。此名稱可包含特殊的星號 ‘*’ 字元。如果您使用 ‘*’ 字元，會以動態方式將其替換為時間戳記。 |
範例：
<Logging Level="Standard" Path="%temp%"
Name="C2RLog(*).txt"
/>
Product 元素
指定所要安裝的隨選即用產品。
語法
<Product
ID="O365ProPlusRetail"
PIDKEY="12345-12345-12345-12345-12345"
>
{1 或 N Language 元素}
</Product>
下表說明 Product 元素屬性及值。
Product 元素屬性及值
| 屬性 | 值 | 描述 | ||
|---|---|---|---|---|
| ID | O365ProPlusRetail | 必要。ID 必須設為有效的 ProductRelease 識別碼。 Office 365 隨選即用產品支援的 ProductRelease 識別碼如下：
如果未設定 ID，則作業會失敗，並會指出該輸入無效。 Product 元素的順序決定產品的安裝順序。第一個 Product ID 用來決定「Microsoft Office 初次執行體驗」應用程式啟動時的環境。「Microsoft Office 初次執行體驗」是指每個 Office 應用程式的第一次啟動。
| ||
| PIDKEY | 12345-12345-12345-12345-12345 | 選用。如果有設定 PIDKEY，就會將所指定的 25 個字元之 PIDKEY 值用於此產品。 |
下列範例指定 Office 365 ProPlus。
<Product ID="O365ProPlusRetail" />下列範例指定美國英文、西班牙文及日文的 Office 365 ProPlus 及 Visio Pro for Office 365。
<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
</Product>
<Product ID="VisioProRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
</Product>
</Add>
Property 元素
支援如下所述的一般屬性。
語法
<Property Name=string Value=string />
其中：
-
Name 是必要屬性。它指出 Property 的名稱。
-
Value 是選用屬性。預設值為空字串。
下表說明 Property 各個元素屬性及值。
Property 元素屬性及值
| 屬性 | 值 | 描述 | ||
|---|---|---|---|---|
| AUTOACTIVATE | 1 0 | 如果 AUTOACTIVATE 設為 1，則指定的產品會嘗試自動啟動。如果未設定 AUTOACTIVATE，則使用者可能會看到 [啟動精靈] UI。
| ||
| FORCEAPPSHUTDOWN | TRUE FALSE | 如果 Office 應用程式正在執行中，可能會阻止安裝或移除動作。這種情形通常會啟動處理程序終止程式 UI。系統管理員可以將 FORCEAPPSHUTDOWN 值設為 TRUE，以避免依賴使用者互動。當 FORCEAPPSHUTDOWN 設為 TRUE 時，會關閉任何阻止動作的應用程式。可能會遺失資料。當 FORCEAPPSHUTDOWN 設為 FALSE (預設值) 時，如果 Office 應用程式正在執行，動作可能會失敗。 |
範例
<Property Name="AUTOACTIVATE" Value="1" />Remove 元素
移除產品和語言。
語法
<Remove
All=TRUE | FALSE
>
{0 或 N Product 元素}
</Remove>
下表說明 Remove 元素屬性及值。
Remove 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| All | TRUE FALSE | 選用。預設值為 FALSE。如果 All 設為 TRUE，則會移除所有隨選即用產品。 |
|
重要事項： |
|---|
| 如果指定了 Product 元素，且其包含 Language 元素識別碼，則安裝程式會移除該產品的語言資源。除非這樣做會移除該產品的所有語言資源，或者，如果 隨選即用 Configuration.xml 檔案中的 Add 元素也指定產品與語言組合，否則一定會如此。 如果指定了 Product 元素，但其不包含 Language 元素，則安裝程式會移除該產品及所有相關聯的語言資源。除非 隨選即用 Configuration.xml 檔的 Add 元素中也有相同的產品，否則一律適用。 如果 All 設為 TRUE，則無論 Add 元素指定什麼，安裝程式都會移除整個安裝。 |
下列範例中的程式碼會移除 Office 365 ProPlus。
<Remove>
<Product ID="O365ProPlusRetail" />
</Remove>下列範例中的程式碼會從 Office 365 ProPlus 安裝移除西班牙語言資源。
<Remove>
<Product ID="O365ProPlusRetail" >
<Language ID="es-es" />
</Product>
</Remove>
下列範例中的程式碼會移除整個安裝。
<Remove All="TRUE" />Updates 元素
指定設定更新的屬性。
語法
<Updates
Enabled=TRUE | FALSE
UpdatePath=UNC | 本機 | http 路徑
TargetVersion=X.Y.Z.W
/>
下表說明 Updates 元素屬性及值。
Updates 元素屬性及值
| 屬性 | 值 | 描述 |
|---|---|---|
| 啟用 | TRUE FALSE | 選用。如果 Enabled 設為 TRUE，隨選即用更新系統將會檢查是否有更新。如果設為 FALSE，則隨選即用更新系統會處於休眠狀態。 |
| UpdatePath | \\server\share\ C:\Preload\Office http://internalApps/Office/ "" | 選用。如果未設定 UpdatePath，隨選即用安裝就會從 Microsoft 隨選即用來源 (內容傳遞網路或 CDN) 取得更新。此為預設值。 如果 UpdatePath 設為空白 ("")，就會從 Microsoft 隨選即用來源 (CDN) 取得更新。 UpdatePath 可以指定隨選即用來源的網路、本機或 HTTP 路徑。 環境變數可用於網路或本機路徑。 |
| TargetVersion | 15.1.2.3 "" | 選用。如果未設定 TargetVersion，隨選即用就會更新為 Microsoft 隨選即用來源中最新的版本。 如果 TargetVersion 設為空白 ("")，隨選即用就會更新為 Microsoft 隨選即用來源中最新的版本。 TargetVersion 可設為 Office 組建編號，例如 15.1.2.3。若已設定版本，Office 就會嘗試在下一次的更新週期中，轉換為指定的版本。 |
在下列範例中，啟用了 Office 更新且使用替代的更新路徑，且產品版本設為 15.1.2.3。
<Updates Enabled="TRUE" UpdatePath="\\Server\share\" TargetVersion="15.1.2.3" />在下列範例中，停用了更新。
<Updates Enabled="FALSE" />隨選即用 Configuration.xml 範例
下列 隨選即用 Configuration.xml 範例檔中的程式碼指定安裝英文版的 32 位元 Office 365 ProPlus 和 Visio Pro for Office 365。它會將更新設為 Enabled，並使用替代的來源。另外它也將 Display Level 設為 None，接受使用者授權合約，且指定記錄檔的名稱。
<Configuration>
<Add SourcePath="\\Server\Share\Office\" OfficeClientEdition="32" >
<Product ID="O365ProPlusRetail">
<Language ID="en-us" />
</Product>
<Product ID="VisioProRetail">
<Language ID="en-us" />
</Product>
</Add>
<Updates Enabled="TRUE" UpdatePath="\\Server\Share\Office\" />
<Display Level="None" AcceptEULA="TRUE" />
<Logging Name="OfficeSetup.txt" Path="%temp%" />
</Configuration>
