New-OfficeWebAppsFarm
在本機電腦上建立新的 Office Online 伺服器伺服器陣列。
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]
New-OfficeWebAppsFarm Cmdlet 會在本機電腦上建立新的Office Online Server伺服器陣列。 您會在 Office Online Server 伺服器陣列的第一部伺服器上執行此 Cmdlet,然後使用 New-OfficeWebAppsMachine Cmdlet 將更多伺服器新增至伺服器陣列。
New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true
本範例會在已在瀏覽器中為 Office 啟用編輯的本機伺服器上建立Office Online Server伺服器陣列。 在此範例中,內部和外部使用者只會使用單一 URL。 [憑證名稱] 值是憑證的 [易記名稱],如同出現在電腦憑證存放區中一樣。
在 Office Online Server 伺服器陣列中的所有伺服器上啟用客戶經驗改進計畫 (CEIP) 報告。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指出應該在埠 80 上布建 IIS 月臺以進行 HTTP 存取。 只有所有電腦均需要 IPSEC (完整加密) 的環境或不含敏感性檔案的測試環境,才可使用 AllowHTTP。
啟用 SSLOffloaded 即會自動啟用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指示可以使用非 SSL 連線 (例如 HTTP) 來建立 Secure Store 連線。 預設為 False。
僅於所有電腦都需要 IPSEC (完整加密) 的環境,或是未包含機密檔案的測試環境中,使用 AllowHTTPSecureStoreConnections。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
允許來自 Office Online Server 的輸出 HTTP 連線。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定用以儲存轉譯後之圖像檔案的全域磁碟快取位置。 預設位置為 %programdata%\Microsoft\OfficeWebApps\Working\d。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定全域磁碟快取的最大大小 (GB)。
此類型必須為 0 到任何正整數之間的整數值。 預設大小為 15 GB。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定憑證的易記名稱,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 |
支援將 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 |
在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定記憶體快取中所能儲存的文件轉換記錄數上限。
預設值為 5000 筆記錄。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
啟用在瀏覽器中編輯的支援。 預設為 False。 唯有當您具有使用編輯功能的適當授權時,才設為 True。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
在資料重新整理失敗時防止活頁簿載入。 這有助於防止使用者檢視過時的資訊或他們可能不應該存取的資訊。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
在活頁簿包含外部資料連線的瀏覽器中,重新整理 Excel 活頁簿中支援的外部資料。 預設為 True。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
這會指定自動重算時,快取動態函數的計算值所需的時間上限 (以秒為單位)。 -1:活頁簿載入時計算一次。 0:自動計算。 1 到 2073600:快取 1 秒到 24 天。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
啟用 Web Excel 工作階段不再使用之檔案的快取。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定 Excel 可在瀏覽器中開啟的圖表或影像大小上限,以 MB 為單位。 此值必須為大於 0 的整數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
這會指定每個工作階段所允許的並行外部資料要求數目上限。 如果工作階段必須發出超過此數目的要求,多出的要求就會排入佇列。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定在瀏覽器中 Excel 外部資料連線的持續時間,以秒為單位。 預設值為 1800 秒。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
PARAMVALUE:File | Manual | Auto | AutoDataTables
Type: | DefaultWorkbookCalcMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定在瀏覽器中 Excel 中外部資料快取存留期的持續時間,以秒為單位。 預設值為 300 秒。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
可以配置給非使用中物件的私用位元組上限百分比。 當超過記憶體快取臨界值時,會釋放目前非使用中的快取的物件。 有效值︰0 (停用非使用中物件的快取);從 1 到 95。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定 Excel 在瀏覽器中使用的最大私用位元組,以 MB 為單位。 若設為 -1,表示私用位元組上限為電腦 50% 的實體記憶體。
其類型必須為 -1 或任何正整數。 預設值為 -1。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。 若超過這段時間,要求便會逾時。
其類型必須為 -1 (沒有限制),或是介於 1 到 2073600 的整數。 預設值為 300。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
允許來自 REST API 的要求重新整理外部資料連線。 如果 [允許外部資料] 設定為 None,則此設定沒有任何作用。 選取方塊布林值。 預設值為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定當沒有任何使用者活動時,會話在瀏覽器中保持作用中的時間,以秒為單位。 有效值包括:
-1 會話永遠不會過期。
0 會話會在單一要求結束時到期。
1 到 2073600 工作階段保持使用中 1 秒到 24 天。 預設值為 450。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
在瀏覽器中啟用 Excel 的使用者定義函式。 預設為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
記憶體快取保留非使用中物件的時間上限 (以分鐘為單位)。 非使用中物件是工作階段不再使用的物件。 有效值︰ -1 (無上限);從 1 到 34560 (24 天)。 預設值為 -1。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
可讓您在瀏覽器中搭配 Excel 使用 Analysis Services EffectiveUserName 參數。 預設為 False。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
在瀏覽器中于 Excel 中重新整理資料時,關閉或開啟顯示的警告對話方塊。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
這會指定可載入之活頁簿的大小上限 (以 MB 為單位)。
其類型必須為整數值,且介於 1 到 2000 之間。 預設值為 10。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定用戶端用來從網際網路存取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 |
指定 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 |
回答「是」會隱藏所有的使用者提示。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定用戶端用來從內部網路存取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 |
指定活動記錄檔在本機電腦上的儲存位置。
伺服器陣列中的每部伺服器無法自訂位置而都會使用此位置。 預設位置為 %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS。
記錄檔的存放磁碟機必須保留足夠的磁碟空間。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定記錄檔的儲存天數。 早於設定日期的記錄檔項目將予刪除。
此類型必須為 0 到 365 之間的整數值。 預設值是 7 天。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定追蹤記錄檔所儲存的資訊量。 其值包括:
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 |
指定轉譯快取所能使用的記憶體空間上限 (MB)。
此類型必須為 0 到任何正整數之間的整數值。 預設大小為 75 MB。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定文件中可翻譯的字元數量上限。
此類型必須是整數值。 此值可設為 0 (表示無限制) 或從 2000 到 2,000,000 的值。 預設值為 125,000。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
開啟或關閉使用線上檢視程式來檢視 UNC 路徑中之 Office 檔案的功能。
您必須先將 OpenFromUrlEnabled 設為 True,線上檢視程式才能顯示 UNC 路徑中的檔案。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
開啟或關閉使用線上檢視器從 URL 或 UNC 路徑檢視 Office 檔案的能力。 預設為 False。
當您使用 ClipartEnabled 時,必須將此參數設定為 True。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
調節某時段中來自給定伺服器的「從 URL 開啟」數量。 無法設定的預設節流值,請確定Office Online Server伺服器陣列不會讓要求在線上檢視者中檢視內容的單一伺服器重迭。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
關閉使用者在瀏覽器中將影像從網頁貼到 Office 的功能。 預設為 False。 如果 OpenFromURLEnabled 設定為 True,且 PicturePasteDisabled 未設定或設定為 False,則使用者可以在瀏覽器中將影像貼到 Office。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定設定為可將 HTTP 要求傳送至外部網站之 Proxy 伺服器的 URL。 一般會搭配 ClipartEnabled 及 TranslationEnabled 參數一起設定。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定單一 Word 或 PowerPoint 進程在回收程式之前可以呈現的檔案數目。
此類型必須為 1 到 1000 之間的整數值。 預設值為 5。
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
從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 |
指定暫時快取的位置,供 Word 和 PowerPoint 檢視服務使用。
預設位置為 %programdata%\Microsoft\OfficeWebApps\Working\waccache。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
憑證的易記名稱,用於使用 SharePoint Server 進行伺服器對伺服器驗證。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
向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 |
支援使用翻譯工具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 |
指定要將翻譯要求傳送到哪個翻譯伺服器 URL。 預設值為 Microsoft Translator 線上服務。 除非您必須變更翻譯服務,否則通常不會使用此參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
指定翻譯服務的應用程式識別碼。 預設值是瀏覽器中 Office 的公用應用程式識別碼。 除非您已經和 Microsoft Translator 協調其他服務,並獲提供私人應用程式識別碼,否則大多不會使用此參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |