Set-OfficeWebAppsFarm
設定現有 Office Online 伺服器伺服器陣列的設定。
Syntax
Set-OfficeWebAppsFarm
[-Force]
[-FarmOU <String>]
[-InternalURL <String>]
[-ExternalURL <String>]
[-AllowHttp]
[-AllowOutboundHttp]
[-SSLOffloaded]
[-CertificateName <String>]
[-S2SCertificateName <String>]
[-EditingEnabled]
[-Proxy <String>]
[-LogLocation <String>]
[-LogRetentionInDays <UInt32>]
[-LogVerbosity <String>]
[-CacheLocation <String>]
[-MaxMemoryCacheSizeInMB <Int32>]
[-DocumentInfoCacheSize <UInt32>]
[-CacheSizeInGB <Int32>]
[-ClipartEnabled]
[-TranslationEnabled]
[-MaxTranslationCharacterCount <Int32>]
[-TranslationServiceAppId <String>]
[-TranslationServiceAddress <String>]
[-RenderingLocalCacheLocation <String>]
[-RecycleActiveProcessCount <UInt32>]
[-AllowCEIP]
[-ExcelRequestDurationMax <Int32>]
[-ExcelSessionTimeout <Int32>]
[-ExcelWorkbookSizeMax <Int32>]
[-ExcelPrivateBytesMax <Int32>]
[-ExcelConnectionLifetime <Int32>]
[-ExcelExternalDataCacheLifetime <Int32>]
[-ExcelAllowExternalData]
[-ExcelUseEffectiveUserName]
[-ExcelWarnOnDataRefresh]
[-ExcelUdfsAllowed]
[-ExcelMemoryCacheThreshold <Int32>]
[-ExcelUnusedObjectAgeMax <Int32>]
[-ExcelCachingUnusedFiles]
[-ExcelAbortOnRefreshOnOpenFail]
[-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
[-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
[-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-ExcelRestExternalDataEnabled]
[-ExcelChartAndImageSizeMax <Int32>]
[-OpenFromUrlEnabled]
[-OpenFromUncEnabled]
[-OpenFromUrlThrottlingEnabled]
[-PicturePasteDisabled]
[-RemovePersonalInformationFromLogs]
[-AllowHttpSecureStoreConnections]
[-WhatIf]
[-Confirm] Description
Set-OfficeWebAppsFarm Cmdlet 會設定現有Office Online Server陣列的設定。
範例
------------------範例 1---------------------
Set-OfficeWebAppsFarm -ClipartEnabled:$true此範例會啟用插入 Office.com 上之美工圖案的功能。
------------------範例 2---------------------
Set-OfficeWebAppsFarm -EditingEnabled:$true此範例會在瀏覽器中啟用 Office 的編輯功能。
------------------範例 3---------------------
Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false此範例會關閉檢視 UNC 路徑中任何 Office 檔案的功能。
參數
-AllowCEIP
在 Office Online Server 伺服器陣列中的所有伺服器上啟用客戶經驗改進計畫 (CEIP) 報告。
您必須重新開機Office Online Server伺服器陣列中的每個伺服器，這項變更才會生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHttp
指出應該在埠 80 上布建 IIS 月臺以進行 HTTP 存取。 只有所有電腦均需要 IPSEC (完整加密) 的環境或不含敏感性檔案的測試環境，才可使用 AllowHTTP。
啟用 SSLOffloaded 即會自動啟用。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHttpSecureStoreConnections
指示可以使用非 SSL 連線 (例如 HTTP) 來建立 Secure Store 連線。 預設為 False。
僅於所有電腦都需要 IPSEC (完整加密) 的環境，或是未包含機密檔案的測試環境中，使用 AllowHTTPSecureStoreConnections。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowOutboundHttp
允許來自 Office Online Server 的輸出 HTTP 連線。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CacheLocation
指定用以儲存轉譯後之圖像檔案的全域磁碟快取位置。 預設位置為 %programdata%\Microsoft\OfficeWebApps\Working\d。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CacheSizeInGB
指定全域磁碟快取的最大大小 (GB)。
此類型必須為 0 到任何正整數之間的整數值。 預設大小為 15 GB。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateName
指定憑證的易記名稱，Office Online Server用來建立 HTTPS 系結。
若找不到指定的憑證或憑證已過期，或是指定的值關聯了多份憑證，除會記錄錯誤之外，也不會建立伺服器陣列。
這個值會用於加入Office Online Server伺服器陣列的每部伺服器上。 因此，伺服器陣列中的每部伺服器皆必須具備名稱易記的憑證。
如果您使用 AllowHttp 或 SSLOffloaded 參數，則不需要指定 CertificateName 參數。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClipartEnabled
支援將美工圖案從 Office.com 插入 Office 檔。 伺服器必須具備網路通訊能力，才可使用此功能；您可以直接設定網路通訊能力，也可使用 Proxy 參數使用 Proxy。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
在執行命令之前，提示您確認操作。 如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DocumentInfoCacheSize
指定記憶體快取中所能儲存的文件轉換記錄數上限。
預設值為 5000 筆記錄。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EditingEnabled
啟用在瀏覽器中編輯的支援。 預設為 False。 唯有當您具有使用編輯功能的適當授權時，才設為 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAbortOnRefreshOnOpenFail
在資料重新整理失敗時防止活頁簿載入。 這有助於防止使用者檢視過時的資訊或他們可能不應該存取的資訊。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAllowExternalData
在活頁簿包含外部資料連線的瀏覽器中，重新整理 Excel 活頁簿中支援的外部資料。 預設為 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAutomaticVolatileFunctionCacheLifeTime
這會指定自動重算時，快取動態函數的計算值所需的時間上限 (以秒為單位)。 -1：活頁簿載入時計算一次。 0：自動計算。 1 到 2073600：快取 1 秒到 24 天。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelCachingUnusedFiles
啟用 Web Excel 工作階段不再使用之檔案的快取。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelChartAndImageSizeMax
指定 Excel 可在瀏覽器中開啟的圖表或影像大小上限，以 MB 為單位。 此值必須為大於 0 的整數。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelConcurrentDataRequestsPerSessionMax
這會指定每個工作階段所允許的並行外部資料要求數目上限。 如果工作階段必須發出超過此數目的要求，多出的要求就會排入佇列。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelConnectionLifetime
指定在瀏覽器中 Excel 外部資料連線的持續時間，以秒為單位。 預設值為 1800 秒。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelDefaultWorkbookCalcMode
PARAMVALUE:File | Manual | Auto | AutoDataTables
| Type: | DefaultWorkbookCalcMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelExternalDataCacheLifetime
指定在瀏覽器中 Excel 中外部資料快取存留期的持續時間，以秒為單位。 預設值為 300 秒。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelMemoryCacheThreshold
可以配置給非使用中物件的私用位元組上限百分比。 當超過記憶體快取臨界值時，會釋放目前非使用中的快取的物件。 有效值︰0 (停用非使用中物件的快取)；從 1 到 95。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelPrivateBytesMax
指定 Excel 在瀏覽器中使用的最大私用位元組，以 MB 為單位。 若設為 -1，表示私用位元組上限為電腦 50% 的實體記憶體。
其類型必須為 -1 或任何正整數。 預設值為 -1。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelRequestDurationMax
這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。 若超過這段時間，要求便會逾時。
其類型必須為 -1 (沒有限制)，或是介於 1 到 2073600 的整數。 預設值為 300。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelRestExternalDataEnabled
允許來自 REST API 的要求重新整理外部資料連線。 如果 [允許外部資料] 設定為 None，則此設定沒有任何作用。 選取方塊布林值。 預設值為 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelSessionTimeout
指定當沒有任何使用者活動時，會話在瀏覽器中保持作用中的時間，以秒為單位。 有效值包括：
-1 會話永遠不會過期。
0 會話會在單一要求結束時到期。
1 到 2073600 工作階段保持使用中 1 秒到 24 天。 預設值為 450。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUdfsAllowed
在瀏覽器中啟用 Excel 的使用者定義函式。 預設為 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUnusedObjectAgeMax
記憶體快取保留非使用中物件的時間上限 (以分鐘為單位)。 非使用中物件是工作階段不再使用的物件。 有效值︰ -1 (無上限)；從 1 到 34560 (24 天)。 預設值為 -1。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUseEffectiveUserName
可讓您在瀏覽器中搭配 Excel 使用 Analysis Services EffectiveUserName 參數。 預設為 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelWarnOnDataRefresh
關閉或開啟在瀏覽器中 Excel 中重新整理資料時所顯示的警告對話方塊。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelWorkbookSizeMax
這會指定可載入之活頁簿的大小上限 (以 MB 為單位)。
其類型必須為整數值，且介於 1 到 2000 之間。 預設值為 10。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExternalURL
指定用戶端用來從網際網路存取Office Online Server伺服器陣列的 URL 根目錄。 在負載平衡、多伺服器Office Online Server伺服器陣列的情況下，外部 URL 會系結至外部面向負載平衡器的 IP 位址。
Office Online Server伺服器陣列需要至少一個 URL，這是使用 ExternalURL 或 InternalURL 所設定。 您也可以同時設定內部及外部的 URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FarmOU
指定 Active Directory 組織單位的名稱， (OU) 伺服器必須是 的成員，才能加入Office Online Server陣列。 使用此參數可防止未經授權的伺服器 (也就是不在 OU 中的伺服器) 加入Office Online Server伺服器陣列。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
回答「是」會隱藏任何使用者提示。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InternalURL
指定用戶端必須用來從內部網路存取Office Online Server伺服器陣列的 URL 根目錄。
Office Online Server陣列至少需要一個 URL。 它是使用 ExternalURL 或 InternalURL 來設定。 您也可以同時設定內部及外部的 URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogLocation
指定活動記錄檔在本機電腦上的儲存位置。
伺服器陣列中的每部伺服器無法自訂位置而都會使用此位置。 預設位置為 %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS。
記錄檔的存放磁碟機必須保留足夠的磁碟空間。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogRetentionInDays
指定記錄檔的儲存天數。 早於設定日期的記錄檔項目將予刪除。
此類型必須為 0 到 365 之間的整數值。 預設值是 7 天。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogVerbosity
指定追蹤記錄檔所儲存的資訊量。 其值包括：
VerboseEX 在追蹤記錄檔中寫入精簡資料。 當資料量可能十分龐大時可使用此值。
Verbose 在追蹤記錄檔中寫入精簡資料。
Medium 在追蹤記錄檔中寫入中等詳細程度的資料。
High 在追蹤記錄檔中寫入詳細資料。
Monitorable 寫入所監視之不尋常程式碼路徑與動作的追蹤資料。
Unexpected 寫入所監視之未預期程式碼路徑與動作的追蹤資料。
None 不在追蹤記錄檔中寫入任何追蹤資訊。
長時間將 LogVerbosity 設於精簡等級，將會對效能造成負面的影響。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxMemoryCacheSizeInMB
指定轉譯快取所能使用的記憶體空間上限 (MB)。
此類型必須為 0 到任何正整數之間的整數值。 預設大小為 1024 MB。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxTranslationCharacterCount
指定文件中可翻譯的字元數上限。
此類型必須是整數值。 此值可設為 0 (表示無限制) 或從 2000 到 2,000,000 的值。 預設值為 125,000。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUncEnabled
開啟或關閉使用線上檢視程式來檢視 UNC 路徑中之 Office 檔案的功能。
您必須先將 OpenFromUrlEnabled 設為 True，線上檢視程式才能顯示 UNC 路徑中的檔案。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUrlEnabled
開啟或關閉使用線上檢視器從 URL 或 UNC 路徑檢視 Office 檔案的能力。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUrlThrottlingEnabled
調節某時段中來自給定伺服器的「從 URL 開啟」數量。 無法設定的預設節流值，請確定Office Online Server伺服器陣列不會讓要求在線上檢視者中檢視內容的單一伺服器重迭。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PicturePasteDisabled
關閉使用者在瀏覽器中將影像從網頁貼到 Office 的功能。 預設為 False。 如果 OpenFromURLEnabled 設定為 True，且 PicturePasteDisabled 未設定或設定為 False，則使用者可以在瀏覽器中將影像貼到 Office。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
指定設定為可將 HTTP 要求傳送至外部網站之 Proxy 伺服器的 URL。 一般會搭配 ClipartEnabled 及 TranslationEnabled 參數一起設定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecycleActiveProcessCount
指定單一 Word 或 PowerPoint 進程在回收程式之前可以呈現的檔案數目。
此類型必須為 1 到 1000 之間的整數值。 預設值為 5。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemovePersonalInformationFromLogs
從Office Online Server記錄檔中提供個人資訊的最佳清除，並將值取代為 SHA256 雜湊。 可清除的資訊包括：
文件名稱及 URL
IP 位址
電子郵件地址
使用者名稱
預設為 False。 請注意，啟用此參數並不保證不會將個人資訊記錄到Office Online Server記錄。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RenderingLocalCacheLocation
指定暫時快取的位置，供 Word 和 PowerPoint 檢視服務使用。
預設位置為 %programdata%\Microsoft\OfficeWebApps\Working\waccache。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-S2SCertificateName
憑證的易記名稱，用於使用 SharePoint Server 進行伺服器對伺服器驗證。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SSLOffloaded
向Office Online Server伺服器陣列中的伺服器指出 SSL 已卸載至負載平衡器。 啟用 SSLOffloaded 時，Web 應用程式會系結至本機伺服器上的埠 80 (HTTP) 。 不過，參考 CSS 或映射等其他資源的 HTML 會針對這些參考使用 HTTPS URL。
您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationEnabled
支援使用翻譯工具Microsoft自動翻譯檔，這是一種線上服務，可在語言之間翻譯文字。 已翻譯的檔案會顯示在 Word 中。 因為Microsoft翻譯工具是線上服務，所以您必須直接啟用伺服器對 Web 通訊，或使用您使用 Proxy 參數指定的 Proxy 來啟用。
Microsoft Translator 可能會為了改善翻譯品質的目的而收集資料。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationServiceAddress
指定要將翻譯要求傳送到哪個翻譯伺服器 URL。 預設值為 Microsoft Translator 線上服務。 除非您必須變更翻譯服務，否則通常不會使用此參數。
您必須重新開機Office Online Server伺服器陣列中的每個伺服器，這項變更才會生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationServiceAppId
指定翻譯服務的應用程式識別碼。 預設值是瀏覽器中 Office 的公用應用程式識別碼。 除非您已經和 Microsoft Translator 協調其他服務，並獲提供私人應用程式識別碼，否則大多不會使用此參數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊，請輸入下列命令：get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |