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 对象。 键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID;服务器场中 Excel Services 应用程序 Web 服务应用程序 的有效名称(例如 MyExcelService1);或有效 SPExcelServiceApplication 对象的实例。 |
ApplicationPool |
可选 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
指定作为 Excel Services 应用程序的名称的现有 IIS 应用程序池。 指定的值必须是有效 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 域中的 Web 部件或页面可以请求和呈现受信任工作簿及数据连接文件。 |
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 参数指定的安全存储服务查找无人参与的服务帐户凭据的应用程序 ID。如果设置了此参数并且发生特定的错误案例,则会联系安全存储服务。有效值为最多含 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% 的可用内存资源)。