New-OfficeWebAppsFarm

參考

模組:: OfficeOnlineServerPowerShell

在本機電腦上建立新的 Office Online 伺服器伺服器陣列。

Syntax

New-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

New-OfficeWebAppsFarm Cmdlet 會在本機電腦上建立新的Office Online Server伺服器陣列。您會在 Office Online Server 伺服器陣列的第一部伺服器上執行此 Cmdlet，然後使用 New-OfficeWebAppsMachine Cmdlet 將更多伺服器新增至伺服器陣列。

範例

------------------範例 1---------------------

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

本範例會在已在瀏覽器中為 Office 啟用編輯的本機伺服器上建立Office Online Server伺服器陣列。在此範例中，內部和外部使用者只會使用單一 URL。 [憑證名稱] 值是憑證的 [易記名稱]，如同出現在電腦憑證存放區中一樣。

參數

-AllowCEIP

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

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

支援將 Bing 影像插入 Office 檔。伺服器必須具備網路通訊能力，才可使用此功能；您可以直接設定網路通訊能力，也可使用 Proxy 參數使用 Proxy。

OpenFromUrlEnabled 參數必須設定為 True，Bing 圖片才能正常運作。預設為 False。

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 到任何正整數之間的整數值。預設大小為 75 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 檔案的能力。預設為 False。

當您使用 ClipartEnabled 時，必須將此參數設定為 True。

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 線上服務。除非您必須變更翻譯服務，否則通常不會使用此參數。

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