Set-SPExcelServiceApplication
適用版本: SharePoint Server 2010
上次修改主題的時間: 2015-03-09
這會設定 Excel Services 應用程式 的通用屬性。
Syntax
Set-SPExcelServiceApplication [[-Identity] <SPExcelServiceApplicationPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-CachingOfUnusedFilesEnable <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-CrossDomainAccessAllowed <SwitchParameter>] [-EncryptedUserConnectionRequired <None | Connection>] [-ExternalDataConnectionLifetime <Int32>] [-FileAccessMethod <UseImpersonation | UseFileAccessAccount>] [-LoadBalancingScheme <WorkbookUrl | RoundRobin | Local>] [-MemoryCacheThreshold <Int32>] [-PrivateBytesMax <Int32>] [-SessionsPerUserMax <Int32>] [-SiteCollectionAnonymousSessionsMax <Int32>] [-TerminateProcessOnAccessViolation <SwitchParameter>] [-ThrottleAccessViolationsPerSiteCollection <Int32>] [-UnattendedAccountApplicationId <String>] [-UnusedObjectAgeMax <Int32>] [-WhatIf [<SwitchParameter>]] [-WorkbookCache <String>] [-WorkbookCacheSizeMax <Int32>]
詳細說明
Set-ExcelServiceApplication Cmdlet 會變更 Excel Services 應用程式 的通用執行階段屬性。使用這個 Cmdlet 對屬性所做的變更,會影響伺服陣列中執行指定的 Excel Services 應用程式 Web 服務應用程式 之執行個體的所有機器。
如需此 Cmdlet 的權限及最新資訊,請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
這會指定要更新的 SPExcelServiceApplication 物件。 其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;在伺服器陣列 (例如,MyExcelService1) 中,Excel Services 應用程式 Web 服務應用程式 的有效名稱;或是有效之 SPExcelServiceApplication 物件的執行個體。 |
ApplicationPool |
選用 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
這會將現有的 IIS 應用程式集區指定為 Excel Services 應用程式的名稱。 其類型必須為有效之 SPIisWebServiceApplicationPool 物件的有效執行個體。 |
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 網域之網頁組件或頁面要求和轉譯。 |
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 Services 應用程式 Web 服務應用程式 電腦時,Excel Services 應用程式 所使用的負載平衡結構描述。預設值為 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--------------
Set-SPExcelServiceApplication ExcelServiceTestApplication -sessionsperusermax 10
此範例會設定名為 ExcelServiceTestApplication
的 Excel Services 應用程式 Web 服務應用程式,好讓每位使用者在執行 Excel Services 應用程式 的後端應用程式伺服器上,一次只能開啟 10
個以內的工作階段。
--------------範例 2--------------
Get-SPExcelServiceApplication | where{ $_.privatebytesmax -ne -1 } | Set-SPExcelServiceApplication -PrivateBytesMax -1
此範例會顯示在伺服器陣列中執行的每一個 Excel Services 應用程式 應用程式,且該伺服器陣列是使用使用者指定的值來指定電腦記憶體的私用位元組上限,然後將該值設定為 -1,這表示 Excel Services 應用程式 將耗用可用記憶體資源的 50%。