通过

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% 的可用内存资源）。

See Also

Reference

Get-SPExcelServiceApplication
New-SPExcelServiceApplication