閱讀英文

共用方式為


New-OfficeWebAppsFarm

在本機電腦上建立新的 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