Set-SPExcelServiceApplication
設定 Excel Services 應用程式的全域屬性。
語法
ExistingTargetApplicationParameterSet
Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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>]
NewTargetApplicationParameterSet
Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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
Cmdlet Set-ExcelServiceApplication 會變更 Excel Services Application 的全域運行時間屬性。
使用此 Cmdlet 對屬性所做的變更，會影響伺服器陣列中執行指定之 Excel Services 應用程式 Web 服務應用程式實例的所有機器。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10
本範例會設定 Excel Services 應用程式，讓每個使用者在執行 Excel Services Application 的後端應用程式伺服器上一次開啟不超過 10 個會話。
範例 2
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1
本範例會將計算機上的記憶體私用位元組數目上限設定為 -1，這表示 Excel Services 應用程式會耗用 50% 的可用記憶體資源。
參數
-AssignmentCollection
適用：SharePoint Server 2010、SharePoint Server 2013
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CachingOfUnusedFilesEnable
適用：SharePoint Server 2010、SharePoint Server 2013
指定 Excel Services 應用程式不再使用的檔案可以保留在快取中，以供稍後使用。 如果命令並未指定參數，則預設為 True。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：SharePoint Server 2010、SharePoint Server 2013
在執行命令之前，提示您確認操作。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CrossDomainAccessAllowed
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定信任的活頁簿和資料連線檔案，可由位於其他 HTTP 網域之網頁組件或頁面要求和轉譯。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EncryptedUserConnectionRequired
適用：SharePoint Server 2010、SharePoint Server 2013
需要在使用者與執行 Excel Services 應用程式的伺服器之間使用加密。 此設定的範圍是邏輯伺服器。 預設值為 None。
其類型必須為下列其中之一：None 或 Connection。
參數屬性
| 類型: | EncryptedConnectionMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExternalDataConnectionLifetime
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定外部資料連線可以在連線集區中保持開啟的秒數上限。
有效值為：
-1 永不回收
1 到 2073600 保持作用中 1 秒到 24 天。
預設值為 1800。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FileAccessMethod
適用：SharePoint Server 2010、SharePoint Server 2013
指定應用程式用來擷取檔案 Excel Services 驗證方法。 UseFileAccessAccount 指定所有活頁簿一律使用執行 Excel Services Application 之服務帳戶的認證。 UseImpersonation 指定 Excel Services 應用程式會以提出要求的使用者身分擷取活頁簿檔案。 預設值為 UseImpersonation。
其類型必須為下列其中之一：UseImpersonation 或 UseFileAccessAccount。
參數屬性
| 類型: | FileAccessMethod |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：SharePoint Server 2010、SharePoint Server 2013
指定要更新的 SPExcelServiceApplication 物件。
其類型必須為有效的 GUID，且格式為 12345678-90ab-cdef-1234-567890bcdefgh；在伺服器陣列 (例如，MyExcelService1) 中，Excel Services 應用程式 Web 服務應用程式的有效名稱；或是有效之 SPExcelServiceApplication 物件的執行個體。
參數屬性
| 類型: | SPExcelServiceApplicationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LoadBalancingScheme
適用：SharePoint Server 2010、SharePoint Server 2013
指定 Excel Services 應用程式 Web 服務應用程式用來將要求傳送至不同後端 Excel Services 應用程式電腦的負載平衡架構。 預設值為 WorkbookURL。
其類型必須為下列其中之一：RoundRobin、Local 或 WorkbookURL。
參數屬性
| 類型: | LoadBalancingScheme |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MemoryCacheThreshold
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定可以配置給非使用中物件之私用位元組上限的百分比。 超過記憶體快取閾值時，目前未在使用中的快取物件會被釋放。 將此值設定為 0 時，會停用非使用中物件的快取。 預設值為 90。
其類型必須為整數，且介於 0 到 95 之間。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrivateBytesMax
適用：SharePoint Server 2010、SharePoint Server 2013
指定 Excel Services Application 所使用的最大私用位元組，以 MB 為單位。 若私用位元組上限設定為 -1，就會預設為電腦上實體記憶體的 50%。 有效值包括代表沒有限制的 -1，以及任何正整數。 預設值為 -1。
其類型必須為 -1 或任何正整數。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SessionsPerUserMax
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定單一使用者被允許的工作階段數目上限。 如果用戶達到這個最大值，則會在新的工作階段啟動時刪除最舊的工作階段。 有效值包括代表沒有限制的 -1，以及任何正整數。 預設值是 25。
其類型必須為 -1 或任何正整數。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SiteCollectionAnonymousSessionsMax
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定每個網站集合所允許的匿名工作階段數目上限。 0 的值會指定不允許匿名工作階段。 有效值包括代表沒有限制的 -1、停用設定的 0，或任何正整數。 預設值是 25。
其類型必須為 -1、0 或任何正整數。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TerminateProcessOnAccessViolation
適用：SharePoint Server 2010、SharePoint Server 2013
在進程中發生存取違規時，終止 Excel Services 應用程式。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ThrottleAccessViolationsPerSiteCollection
適用：SharePoint Server 2010、SharePoint Server 2013
指定如果活頁簿在 Excel Services 應用程式上造成存取違規錯誤，則源自該活頁簿網站集合的所有檔案在指定期間內都會遭到封鎖， (以秒為單位) 。 該網站集合上之檔案的現有工作階段則不受影響。 有效值包括停用設定的 0，以及從 1 到 2073600 秒 (24 天) 的範圍。 預設值為 0。
其類型必須為整數值，且介於 0 到 2073600 之間。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UnattendedAccountApplicationId
適用：SharePoint Server 2010、SharePoint Server 2013
指定用來從 UnattendedAccountSecureServiceAppName 參數所指定的安全記憶體服務查閱自動服務帳戶認證的應用程式識別碼。 設定此參數且發生特定錯誤案例時，會連絡安全的記憶體服務。 有效值為最多包含 256 個英數字元的字串。 預設值為空白字串。
其類型必須為有效的英數字元字串；例如，UnattendedServiceAccountID。
自動帳戶是所有活頁簿可用來重新整理資料的單一帳戶。 當活頁簿連線的驗證指定為 None 時，或是使用任何非 Windows 認證來重新整理資料時，就會需要自動帳戶。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ExistingTargetApplicationParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UnattendedServiceAccount
適用：SharePoint Server 2013
自動服務帳戶是一個帳戶，所有活頁簿都可以用來重新整理數據。 當活頁簿連線指定「使用自動服務帳戶」而不使用 Windows 認證時，需要此帳戶才能重新整理數據。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
NewTargetApplicationParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UnusedObjectAgeMax
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定時間上限 (以分鐘為單位)，亦即工作階段中目前並未使用的物件保留在記憶體快取中的時間。 有效值包括沒有上限的 -1，以及介於 1 到 34560 分鐘 (24 天) 之間的正整數。 預設值為 -1。
其類型必須為 -1，或是介於 1 到 34560 的整數。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseEffectiveUserName
適用：SharePoint Server 2013
UseEffectiveUserName 屬性是 Windows 委派的替代方案，可讓使用者安全地存取 Analysis Services 數據。
此設定只會影響以 Analysis Services 活頁簿連線為基礎的外部數據連線，其驗證設定為 [使用已驗證的用戶帳戶]。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：SharePoint Server 2010、SharePoint Server 2013
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WorkbookCache
適用：SharePoint Server 2010、SharePoint Server 2013
指定快取的本機檔系統位置，該快取用來儲存 Excel Services 應用程式所使用的活頁簿。
如果未指定任何值，預設值會是系統暫存目錄中的子目錄。
此類型必須是下列其中一種格式的有效路徑：
-- C：\folder_name -- \\server_name\folder_name
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WorkbookCacheSizeMax
適用：SharePoint Server 2010、SharePoint Server 2013
這會指定個別工作階段的大小上限 (以 MB 為單位)。 預設值為 0。
其類型必須為任何正整數。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WorkbookModelUsageTracker
適用：SharePoint Server 2013
{{Fill WorkbookModelUsageTracker Description}}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。