New-SPExcelServiceApplication

發行項
11/25/2016

適用版本： SharePoint Server 2010

上次修改主題的時間： 2015-03-09

這會建立 Excel Services 應用程式的新執行個體。

Syntax

New-SPExcelServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-CachingOfUnusedFilesEnable <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-CrossDomainAccessAllowed <SwitchParameter>] [-Default <SwitchParameter>] [-EncryptedUserConnectionRequired <None | Connection>] [-ExternalDataConnectionLifetime <Int32>] [-FileAccessMethod <UseImpersonation | UseFileAccessAccount>] [-LoadBalancingScheme <WorkbookUrl | RoundRobin | Local>] [-MemoryCacheThreshold <Int32>] [-Name <String>] [-PrivateBytesMax <Int32>] [-SessionsPerUserMax <Int32>] [-SiteCollectionAnonymousSessionsMax <Int32>] [-TerminateProcessOnAccessViolation <SwitchParameter>] [-ThrottleAccessViolationsPerSiteCollection <Int32>] [-UnattendedAccountApplicationId <String>] [-UnusedObjectAgeMax <Int32>] [-WhatIf [<SwitchParameter>]] [-WorkbookCache <String>] [-WorkbookCacheSizeMax <Int32>]

詳細說明

New-SPExcelServiceApplication Cmdlet 會使用新設定來建立新的 Excel Services 應用程式 Web 服務應用程式。建立新的 Excel Services 應用程式 Web 服務應用程式之後，您可以使用 Set-SPExcelServiceApplication Cmdlet 來修改新應用程式的通用設定。

如需此 Cmdlet 的權限及最新資訊，請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數	必要	類型	描述
ApplicationPool	必要	Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind	這會為新的 Excel Service 應用程式，指定要執行 Web 服務的現有 IIS 應用程式集區。其類型必須為有效的 SPIisWebServiceApplicationPool 物件。
Name	必要	System.String	這會為新的 Excel Services 應用程式 Web 服務應用程式指定易記的名稱。您使用的名稱必須是此伺服器陣列中，Excel Services 應用程式 Web 服務應用程式的唯一名稱。名稱最多可使用 128 個字元。預設值為 Service_numofapplications+1。其類型必須為有效的字串；例如，MyExcelServiceApp1。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
CachingOfUnusedFilesEnable	選用	System.Management.Automation.SwitchParameter	這會指定 Excel Services 應用程式不再使用的檔案，可以保留在快取中供後續使用。如果命令並未指定參數，則預設為 True。
Confirm	選用	System.Management.Automation.SwitchParameter	執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters
CrossDomainAccessAllowed	選用	System.Management.Automation.SwitchParameter	這會指定信任的活頁簿和資料連線檔案，可由位於其他 HTTP 網域之網頁組件或頁面要求和轉譯。
Default	選用	System.Management.Automation.SwitchParameter	這會指定此服務應用程式的 Proxy 新增到伺服器陣列的預設 Proxy 群組。
EncryptedUserConnectionRequired	選用	Microsoft.Office.Excel.Server.EncryptedConnectionMode	這會要求使用者與 Excel Services 應用程式伺服器之間必須使用加密。此設定的範圍是邏輯伺服器；預設值為 None。其類型必須為下列其中之一：None 或 Connection。
ExternalDataConnectionLifetime	選用	System.Int32	這會指定外部資料連線可以在連線集區中保持開啟的秒數上限。有效值包括： -1，永遠不回收 1 到 2073600，保持使用中 1 秒到 24 天。預設值為 1800。
FileAccessMethod	選用	Microsoft.Office.Excel.Server.FileAccessMethod	這會指定 Excel Services 應用程式用來擷取檔案的驗證方法。UseFileAccessAccount 會指定所有活頁簿永遠使用執行 Excel Services 應用程式的服務帳戶認證。UseImpersonation 會指定當使用者要求擷取活頁簿檔案時，Excel Services 應用程式以該名使用者的身分執行這項作業。預設值為 UseImpersonation。其類型必須為下列其中之一：UseImpersonation 或 UseFileAccessAccount。
LoadBalancingScheme	選用	Microsoft.Office.Excel.Server.LoadBalancingScheme	這會指定在傳送要求到執行 Excel Calculation Services 的不同後端電腦時，Excel Services 應用程式 Web 服務應用程式所使用的負載平衡結構描述。預設值為 WorkbookURL。其類型必須為下列其中之一：RoundRobin、Local 或 WorkbookURL。
MemoryCacheThreshold	選用	System.Int32	這會指定可以配置給非使用中物件之私用位元組上限的百分比。超過記憶體快取閾值時，目前未在使用中的快取物件會被釋放。將此值設定為 0 時，會停用非使用中物件的快取。預設值為 90。其類型必須為整數，且介於 0 到 95 之間。
PrivateBytesMax	選用	System.Int32	這會指定 Excel Services 應用程式所使用的私用位元組上限 (以 MB 為單位)。若私用位元組上限設定為 -1，就會預設為電腦上實體記憶體的 50%。有效值包括代表沒有限制的 -1，以及任何正整數。預設值為 -1。其類型必須為 -1 或任何正整數。
SessionsPerUserMax	選用	System.Int32	這會指定單一使用者被允許的工作階段數目上限。如果使用者達到此上限，在新的工作階段開始時會刪除最舊的工作階段。有效值包括代表沒有限制的 -1，以及任何正整數。預設值為 25。其類型必須為 -1 或任何正整數。
SiteCollectionAnonymousSessionsMax	選用	System.Int32	這會指定每個網站集合所允許的匿名工作階段數目上限。0 的值會指定不允許匿名工作階段。有效值包括代表沒有限制的 -1、停用設定的 0，或任何正整數。預設值為 25。其類型必須為 -1、0 或任何正整數。
TerminateProcessOnAccessViolation	選用	System.Management.Automation.SwitchParameter	在程序中發生存取違規時，會終止 Excel Services 應用程式。
ThrottleAccessViolationsPerSiteCollection	選用	System.Int32	這會指定如果活頁簿在 Excel Services 應用程式上造成存取違規錯誤，那麼源自該活頁簿網站集合的所有檔案都會在指定期間 (以秒為單位) 內禁止載入。該網站集合上之檔案的現有工作階段則不受影響。有效值包括停用設定的 0，以及從 1 到 2073600 秒 (24 天) 的範圍。預設值為 0。其類型必須為整數值，且介於 0 到 2073600 之間。
UnattendedAccountApplicationId	選用	System.String	這會指定應用程式識別碼，用於查閱由 UnattendedAccountSecureServiceAppName 所指定之安全存放服務的自動服務帳戶認證。如果已設定此參數，且發生特定錯誤，便會連絡安全存放服務。有效值為最多包含 256 個英數字元的字串。預設值為空白字串。其類型必須為有效的英數字元字串；例如，UnattendedServiceAccountID。注意自動帳戶是所有活頁簿可用來重新整理資料的單一帳戶。當活頁簿連線的驗證指定為 None 時，或是使用任何非 Windows 認證來重新整理資料時，就會需要自動帳戶。
UnusedObjectAgeMax	選用	System.Int32	這會指定時間上限 (以分鐘為單位)，亦即工作階段中目前並未使用的物件保留在記憶體快取中的時間。有效值包括沒有上限的 -1，以及介於 1 到 34560 分鐘 (24 天) 之間的正整數。預設值為 -1。其類型必須為 -1，或是介於 1 到 34560 的整數。
WhatIf	選用	System.Management.Automation.SwitchParameter	顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters
WorkbookCache	選用	System.String	這會指定快取的本機檔案系統位置，此快取是用來存放 Excel Services 應用程式所使用的活頁簿。若未指定任何值，則預設值為系統暫存目錄的子目錄。其類型必須為有效的路徑，且格式為下列之一： -- C:\folder_name -- \\server_name\folder_name
WorkbookCacheSizeMax	選用	System.Int32	這會指定個別工作階段的大小上限 (以 MB 為單位)。預設值為 0。其類型必須為任何正整數。

輸入類型

傳回類型

Example

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

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

此範例會建立 Excel Services 應用程式的新執行個體，且顯示名稱為 MyExcelService。

--------------範例 2--------------

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

此範例會建立 Excel Services 應用程式的新執行個體，且顯示名稱為 My Excel Service，而且針對執行 Excel Services 應用程式的每個後端應用程式伺服器電腦，每位使用者都只允許五個工作階段。

共用方式為