New-SPExcelServiceApplication

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

Syntax

New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnattendedAccountApplicationId <String>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]
New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UnattendedServiceAccount <PSCredential>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]

Description

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

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

------------------範例 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 Application 的每部後端應用程式伺服器電腦,每個使用者只允許五個會話。

參數

-ApplicationPool

這會為新的 Excel Service 應用程式,指定要執行 Web 服務的現有 IIS 應用程式集區。

其類型必須為有效的 SPIisWebServiceApplicationPool 物件。

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-AssignmentCollection

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-CachingOfUnusedFilesEnable

指定Excel Services應用程式不再使用的檔案可以保留在快取中,以供稍後使用。 如果命令並未指定參數,則預設為 True。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Confirm

在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-CrossDomainAccessAllowed

這會指定信任的活頁簿和資料連線檔案,可由位於其他 HTTP 網域之網頁組件或頁面要求和轉譯。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Default

這會指定此服務應用程式的 Proxy 新增到伺服器陣列的預設 Proxy 群組。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-EncryptedUserConnectionRequired

要求使用者與Excel Services應用程式伺服器之間使用加密。 此設定的範圍是邏輯伺服器。 預設值為 None。

其類型必須為下列其中之一:None 或 Connection。

Type:EncryptedConnectionMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExternalDataConnectionLifetime

這會指定外部資料連線可以在連線集區中保持開啟的秒數上限。 有效值包括:

-1 永不回收

1 到 2073600 保持作用中 1 秒到 24 天。

預設值為 1800。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-FileAccessMethod

指定應用程式用來擷取檔案Excel Services驗證方法。 UseFileAccessAccount 指定所有活頁簿一律使用執行 Excel Services 應用程式之服務帳戶的認證。 UseImpersonation 指定Excel Services應用程式會以提出要求的使用者身分擷取活頁簿檔案。 預設值為 UseImpersonation。

其類型必須為下列其中之一:UseImpersonation 或 UseFileAccessAccount。

Type:FileAccessMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-LoadBalancingScheme

指定負載平衡架構,Excel Services應用程式 Web 服務應用程式用來將要求傳送至執行 Excel Calculation Services 的不同後端電腦。 預設值為 WorkbookURL。

其類型必須為下列其中之一:RoundRobin、Local 或 WorkbookURL。

Type:LoadBalancingScheme
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-MemoryCacheThreshold

這會指定可以配置給非使用中物件之私用位元組上限的百分比。 超過記憶體快取閾值時,目前未在使用中的快取物件會被釋放。 將此值設定為 0 時,會停用非使用中物件的快取。 預設值為 90。

其類型必須為整數,且介於 0 到 95 之間。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Name

指定新Excel Services應用程式 Web 服務應用程式的易記名稱。 您使用的名稱必須是此伺服器陣列中Excel Services應用程式 Web 服務應用程式的唯一名稱。 名稱最長可包含 128 個字元。 預設值為 Service_numofapplications+1。

其類型必須為有效的字串;例如,MyExcelServiceApp1。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-PrivateBytesMax

指定 Excel Services Application 所使用的最大私用位元組,以 MB 為單位。 若私用位元組上限設定為 -1,就會預設為電腦上實體記憶體的 50%。 有效值包括代表沒有限制的 -1,以及任何正整數。 預設值為 -1。

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SessionsPerUserMax

這會指定單一使用者被允許的工作階段數目上限。 如果使用者達到此上限,在新的工作階段開始時會刪除最舊的工作階段。 有效值包括代表沒有限制的 -1,以及任何正整數。 預設值是 25。

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SiteCollectionAnonymousSessionsMax

這會指定每個網站集合所允許的匿名工作階段數目上限。 0 的值會指定不允許匿名工作階段。 有效值包括代表沒有限制的 -1、停用設定的 0,或任何正整數。 預設值是 25。

其類型必須為 -1、0 或任何正整數。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-TerminateProcessOnAccessViolation

在進程中發生存取違規時,終止Excel Services應用程式。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ThrottleAccessViolationsPerSiteCollection

指定如果活頁簿在 Excel Services Application 上造成存取違規錯誤,則源自該活頁簿網站集合的所有檔案在指定期間內都會遭到封鎖, (以秒為單位) 。 該網站集合上之檔案的現有工作階段則不受影響。 有效值包括停用設定的 0,以及從 1 到 2073600 秒 (24 天) 的範圍。 預設值為 0。

其類型必須為整數值,且介於 0 到 2073600 之間。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedAccountApplicationId

這會指定應用程式識別碼,用於查閱由 UnattendedAccountSecureServiceAppName 所指定之安全存放服務的自動服務帳戶認證。 如果已設定此參數,且發生特定錯誤,便會連絡安全存放服務。 有效值為最多包含 256 個英數字元的字串。 預設值為空白字串。

其類型必須為有效的英數字元字串;例如,UnattendedServiceAccountID。

自動帳戶是所有活頁簿可用來重新整理資料的單一帳戶。 當活頁簿連線的驗證指定為 None 時,或是使用任何非 Windows 認證來重新整理資料時,就會需要自動帳戶。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedServiceAccount

{{填入 UnattendedServiceAccount Description}}

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnusedObjectAgeMax

這會指定時間上限 (以分鐘為單位),亦即工作階段中目前並未使用的物件保留在記憶體快取中的時間。 有效值包括沒有上限的 -1,以及介於 1 到 34560 分鐘 (24 天) 之間的正整數。 預設值為 -1。

其類型必須為 -1,或是介於 1 到 34560 的整數。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UseEffectiveUserName

{{Fill UseEffectiveUserName Description}}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WhatIf

顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookCache

指定快取的本機檔案系統位置,該快取用於儲存Excel Services應用程式所使用的活頁簿。

若未指定任何值,則預設值為系統暫存目錄的子目錄。

此類型必須是下列其中一種格式的有效路徑:

-- C:\folder_name -- \\server_name\folder_name

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookCacheSizeMax

這會指定個別工作階段的大小上限 (以 MB 為單位)。 預設值為 0。

其類型必須為任何正整數。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookModelUsageTracker

{{Fill WorkbookModelUsageTracker Description}}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013