Set-SPExcelServiceApplication

設定 Excel Services 應用程式的全域屬性。

Syntax

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>]
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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-EncryptedUserConnectionRequired

需要在使用者與執行 Excel Services Application 的伺服器之間使用加密。 此設定的範圍是邏輯伺服器。 預設值為 None。

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

Type:EncryptedConnectionMode
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Identity

指定要更新的 SPExcelServiceApplication 物件。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;在伺服器陣列 (例如,MyExcelService1) 中,Excel Services 應用程式 Web 服務應用程式的有效名稱;或是有效之 SPExcelServiceApplication 物件的執行個體。

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

-LoadBalancingScheme

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

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

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

-MemoryCacheThreshold

Specifies the percentage of the maximum private bytes that can be allocated to inactive objects. When the memory cache threshold is exceeded, cached objects that are not currently in use are released. Setting this value to 0 disables caching of inactive objects. The default value is 90.

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

Type:Int32
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SiteCollectionAnonymousSessionsMax

Specifies the maximum number of anonymous sessions allowed per site collection. A value of 0 specifies that no anonymous sessions are allowed. Valid values include -1 for no limit, 0 to disable the setting, or any positive integer. The default value is 25.

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

Type:Int32
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedAccountApplicationId

指定用來從 UnattendedAccountSecureServiceAppName 參數所指定的安全儲存體服務查閱自動服務帳戶認證的應用程式識別碼。 設定此參數且發生特定錯誤案例時,會連絡安全的儲存體服務。 有效值為最多包含 256 個英數字元的字串。 預設值為空白字串。

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

The unattended account is a single account that all workbooks can use to refresh data. An unattended account is required when workbook connections specify None for authentication, or when any non-Windows credentials are used to refresh data.

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

-UnattendedServiceAccount

自動服務帳戶是一個帳戶,所有活頁簿都可以用來重新整理資料。 當活頁簿連線指定「使用自動服務帳戶」而不使用 Windows 認證時,需要此帳戶才能重新整理資料。

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

-UnusedObjectAgeMax

Specifies the maximum amount of time, in minutes, that objects not currently used in a session are kept in the memory cache. Valid values include -1 for no maximum setting, and a positive integer in the range of 1 to 34560 minutes (24 days). The default value is -1.

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

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

-UseEffectiveUserName

UseEffectiveUserName 屬性是 Windows 委派的替代方案,可讓使用者安全地存取 Analysis Services 資料。

此設定只會影響以 Analysis Services 活頁簿連線為基礎的外部資料連線,其驗證設定為 [使用已驗證的使用者帳戶]。

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013