Set-OfficeWebAppsFarm

語法

Default (預設值)

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

範例

範例 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

範例 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

範例 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

參數

-AllowCEIP

在 Office Online Server 伺服器陣列的所有伺服器上啟用客戶體驗改進計劃 (CEIP) 報告。

您必須重新啟動 Office Online Server 陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-AllowHttp

指出 IIS 網站應在連接埠 80 上佈建以供 HTTP 存取。 只有所有電腦均需要 IPSEC (完整加密) 的環境或不含敏感性檔案的測試環境，才可使用 AllowHTTP。

啟用 SSLOffloaded 即會自動啟用。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-AllowHttpSecureStoreConnections

指示可以使用非 SSL 連線 (例如 HTTP) 來建立 Secure Store 連線。 預設為 False。

僅於所有電腦都需要 IPSEC (完整加密) 的環境，或是未包含機密檔案的測試環境中，使用 AllowHTTPSecureStoreConnections。

參數屬性

參數集

-AllowOutboundHttp

允許來自 Office Online Server 的輸出 HTTP 連線。

參數屬性

參數集

-CacheLocation

指定用以儲存轉譯後之圖像檔案的全域磁碟快取位置。 預設位置是 %programdata%\Microsoft\OfficeWebApps\Working\d\。

參數屬性

參數集

-CacheSizeInGB

指定全域磁碟快取的最大大小 (GB)。 此類型必須為 0 到任何正整數之間的整數值。 預設大小為 15 GB。

參數屬性

參數集

-CertificateName

指定 Office Online Server 用來建立 HTTPS 繫結的憑證易記名稱。

若找不到指定的憑證或憑證已過期，或是指定的值關聯了多份憑證，除會記錄錯誤之外，也不會建立伺服器陣列。

這個值會在加入 Office Online Server 陣列的每一部伺服器上使用。 因此，伺服器陣列中的每部伺服器皆必須具備名稱易記的憑證。

如果您使用的是 AllowHttp 或 SSLOffloaded 參數，則不需要指定 CertificateName 參數。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-ClipartEnabled

啟用將 Office.com 中的美工圖案插入 Office 文件的支援。 伺服器必須具備網路通訊能力，才可使用此功能；您可以直接設定網路通訊能力，也可使用 Proxy 參數使用 Proxy。

參數屬性

參數集

-Confirm

在執行命令之前，提示您確認操作。

參數屬性

參數集

-DocumentInfoCacheSize

指定記憶體快取中所能儲存的文件轉換記錄數上限。

預設值為 5000 筆記錄。

參數屬性

參數集

-EditingEnabled

啟用在瀏覽器中編輯的支援。 預設為 False。 唯有當您具有使用編輯功能的適當授權時，才設為 True。

參數屬性

參數集

-ExcelAbortOnRefreshOnOpenFail

在資料重新整理失敗時防止活頁簿載入。 這有助於防止使用者檢視過時的資訊或他們可能不應該存取的資訊。

參數屬性

參數集

-ExcelAllowExternalData

在活頁簿包含外部資料連線的瀏覽器中，啟用 Excel 活頁簿中支援的重新整理外部資料。 預設為 True。

參數屬性

參數集

-ExcelAutomaticVolatileFunctionCacheLifeTime

這會指定自動重算時，快取動態函數的計算值所需的時間上限 (以秒為單位)。

• -1：活頁簿載入時計算一次。
• 0：自動計算。
• 1 到 2073600：快取 1 秒到 24 天。

參數屬性

參數集

-ExcelCachingUnusedFiles

啟用 Web Excel 工作階段不再使用之檔案的快取。

參數屬性

參數集

-ExcelChartAndImageSizeMax

指定 Excel 可在瀏覽器中開啟的圖表或影像的大小上限，以 MB 為單位。 此值必須為大於 0 的整數。

參數屬性

參數集

-ExcelConcurrentDataRequestsPerSessionMax

這會指定每個工作階段所允許的並行外部資料要求數目上限。 如果工作階段必須發出超過此數目的要求，多出的要求就會排入佇列。

參數屬性

參數集

-ExcelConnectionLifetime

指定瀏覽器中 Excel 外部資料連線的持續時間，以秒為單位。 預設值為 1800 秒。

參數屬性

參數集

-ExcelDefaultWorkbookCalcMode

PARAMVALUE:File | Manual | Auto | AutoDataTables

參數屬性

參數集

-ExcelExternalDataCacheLifetime

在瀏覽器中指定 Excel 中外部資料快取存留期的持續時間，以秒為單位。 預設值為 300 秒。

參數屬性

參數集

-ExcelMemoryCacheThreshold

可以配置給非使用中物件的私用位元組上限百分比。 當超過記憶體快取臨界值時，會釋放目前非使用中的快取的物件。 有效值︰0 (停用非使用中物件的快取)；從 1 到 95。

參數屬性

參數集

-ExcelPrivateBytesMax

指定 Excel 在瀏覽器中使用的私人位元組上限，以 MB 為單位。 若設為 -1，表示私用位元組上限為電腦 50% 的實體記憶體。

其類型必須為 -1 或任何正整數。 預設值為 -1。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-ExcelRequestDurationMax

這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。 若超過這段時間，要求便會逾時。

其類型必須為 -1 (沒有限制)，或是介於 1 到 2073600 的整數。 預設值為 300。

參數屬性

參數集

-ExcelRestExternalDataEnabled

允許來自 REST API 的要求重新整理外部資料連線。 如果 [允許外部資料] 設定為 None，則此設定沒有任何作用。 選取方塊布林值。 預設值為 False。

參數屬性

參數集

-ExcelSessionTimeout

指定當沒有使用者活動時，在瀏覽器中 Excel 中的工作階段保持作用中的時間，以秒為單位。 有效值包括：

• -1 工作階段永不過期。
• 0 工作階段會在單一要求結束時到期。
• 1 到 2073600 工作階段保持使用中 1 秒到 24 天。

預設值為 450。

參數屬性

參數集

-ExcelUdfsAllowed

在瀏覽器中為 Excel 啟用使用者定義函數。 預設為 False。

參數屬性

參數集

-ExcelUnusedObjectAgeMax

記憶體快取保留非使用中物件的時間上限 (以分鐘為單位)。 非使用中物件是工作階段不再使用的物件。

有效值：

• -1 (無最大)
• 1 到 34560 之間 (24 天) 。

預設值為 -1。

參數屬性

參數集

-ExcelUseEffectiveUserName

讓您能在瀏覽器中搭配 Excel 使用 Analysis Services EffectiveUserName 參數。 預設為 False。

參數屬性

參數集

-ExcelWarnOnDataRefresh

關閉或開啟當瀏覽器中的 Excel 資料重新整理時顯示的警告對話方塊。

參數屬性

參數集

-ExcelWorkbookSizeMax

這會指定可載入之活頁簿的大小上限 (以 MB 為單位)。

其類型必須為整數值，且介於 1 到 2000 之間。 預設值為 10。

參數屬性

參數集

-ExternalURL

指定用戶端用來從網際網路存取 Office Online Server 陣列的 URL 根目錄。 在負載平衡的多伺服器 Office Online Server 陣列中，外部 URL 會繫結至外部對向負載平衡器的 IP 位址。

一個 Office Online Server 陣列至少需要一個 URL，即使用 ExternalURL 或 InternalURL 進行設定。 您也可以同時設定內部及外部的 URL。

參數屬性

參數集

-FarmOU

指定伺服器必須是成員才能加入 Office Online Server 陣列的 Active Directory 組織單位 (OU) 名稱。 使用此參數可防止未經授權的伺服器加入 (即不在 OU) 中的伺服器加入 Office Online Server 陣列。

參數屬性

參數集

-Force

回答「是」會隱藏任何使用者提示。

參數屬性

參數集

-InternalURL

指定用戶端必須用來從內部網路存取 Office Online Server 陣列的 URL 根目錄。

一個 Office Online Server 陣列至少需要一個 URL。 它是使用 ExternalURL 或 InternalURL 進行設定。 您也可以同時設定內部及外部的 URL。

參數屬性

參數集

-LogLocation

指定活動記錄檔在本機電腦上的儲存位置。

伺服器陣列中的每部伺服器無法自訂位置而都會使用此位置。 預設位置是 %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\。

記錄檔的存放磁碟機必須保留足夠的磁碟空間。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-LogRetentionInDays

指定記錄檔的儲存天數。 早於設定日期的記錄檔項目將予刪除。

此類型必須為 0 到 365 之間的整數值。 預設值是 7 天。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-LogVerbosity

指定追蹤記錄檔所儲存的資訊量。 其值包括：

• VerboseEX 在追蹤記錄檔中寫入精簡資料。 當資料量可能十分龐大時可使用此值。
• Verbose 在追蹤記錄檔中寫入精簡資料。
• Medium 在追蹤記錄檔中寫入中等詳細程度的資料。
• High 在追蹤記錄檔中寫入詳細資料。
• Monitorable 寫入所監視之不尋常程式碼路徑與動作的追蹤資料。
• Unexpected 寫入所監視之未預期程式碼路徑與動作的追蹤資料。
• None 不在追蹤記錄檔中寫入任何追蹤資訊。

長時間將 LogVerbosity 設於精簡等級，將會對效能造成負面的影響。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-MaxMemoryCacheSizeInMB

指定轉譯快取所能使用的記憶體空間上限 (MB)。

此類型必須為 0 到任何正整數之間的整數值。 預設大小為 1024 MB。

參數屬性

參數集

-MaxTranslationCharacterCount

指定文件中可翻譯的字元數上限。

此類型必須是整數值。 此值可設為 0 (表示無限制) 或從 2000 到 2,000,000 的值。 預設值為 125,000。

參數屬性

參數集

-OpenFromUncEnabled

開啟或關閉使用線上檢視程式來檢視 UNC 路徑中之 Office 檔案的功能。

您必須先將 OpenFromUrlEnabled 設為 True，線上檢視程式才能顯示 UNC 路徑中的檔案。

參數屬性

參數集

-OpenFromUrlEnabled

開啟或關閉使用線上檢視器從 URL 或 UNC 路徑檢視 Office 檔案的功能。

參數屬性

參數集

-OpenFromUrlThrottlingEnabled

調節某時段中來自給定伺服器的「從 URL 開啟」數量。 預設節流值無法設定，可確保 Office Online Server 陣列不會因為要求在線上檢視器中檢視內容而使單一伺服器不堪重負。

參數屬性

參數集

-PicturePasteDisabled

關閉使用者在瀏覽器中將網頁中的影像貼到 Office 的功能。 預設為 False。 如果 OpenFromURLEnabled 設定為 True，且 PicturePasteDisabled 未設定或設定為 False，則使用者可以在瀏覽器中將影像貼到 Office 中。

參數屬性

參數集

-Proxy

指定設定為可將 HTTP 要求傳送至外部網站之 Proxy 伺服器的 URL。 一般會搭配 ClipartEnabled 及 TranslationEnabled 參數一起設定。

參數屬性

參數集

-RecycleActiveProcessCount

指定單一 Word 或 PowerPoint 程序在回收程序之前可以轉譯的檔案數。 此類型必須為 1 到 1000 之間的整數值。 預設值為 5。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-RemovePersonalInformationFromLogs

提供從 Office Online Server 記錄中盡力清除個人資訊，並以 SHA256 雜湊取代值。 可清除的資訊包括：

• 文件名稱及 URL
• IP 位址
• 電子郵件地址
• 使用者名稱

預設為 False。 請注意，啟用此參數並不能保證個人資訊不會記錄到 Office Online Server 記錄檔。

參數屬性

參數集

-RenderingLocalCacheLocation

指定供 Word 和 PowerPoint 檢視服務使用的暫存快取的位置。

預設位置是 %programdata%\Microsoft\OfficeWebApps\Working\waccache\。

參數屬性

參數集

-S2SCertificateName

使用 SharePoint Server 進行伺服器對伺服器驗證所用的憑證易記名稱。

參數屬性

參數集

-SSLOffloaded

向 Office Online Server 陣列中的伺服器指出 SSL 已卸載至負載平衡器。 啟用 SSLOffloaded 時，Web 應用程式會繫結至本機伺服器上的連接埠 80 (HTTP) 。 不過，參考其他資源 （例如 CSS 或影像） 的 HTML 會針對這些參考使用 HTTPS URL。

您必須重新啟動伺服器陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-TranslationEnabled

使用 Microsoft 翻譯工具啟用自動文件翻譯的支援，這是一項可在語言之間翻譯文字的線上服務。 翻譯後的檔案隨即在 Word 中顯示。 由於 Microsoft 翻譯工具是一項線上服務，您必須直接啟用伺服器對 Web 的通訊，或使用您使用 Proxy 參數指定的 Proxy。

Microsoft Translator 可能會為了改善翻譯品質的目的而收集資料。

參數屬性

參數集

-TranslationServiceAddress

指定要將翻譯要求傳送到哪個翻譯伺服器 URL。 預設值為 Microsoft Translator 線上服務。 除非您必須變更翻譯服務，否則通常不會使用此參數。

您必須重新啟動 Office Online Server 陣列中的每部伺服器，此變更才會生效。

參數屬性

參數集

-TranslationServiceAppId

指定翻譯服務的應用程式識別碼。 預設值為瀏覽器中 Office 的公用應用程式識別碼。 除非您已經和 Microsoft Translator 協調其他服務，並獲提供私人應用程式識別碼，否則大多不會使用此參數。

參數屬性

參數集

-WhatIf

顯示訊息會描述命令的功效而不執行命令。

參數屬性

參數集