Set-SPExcelServiceApplication

模块:

SharePointServer

适用于:

SharePoint Server 2010, SharePoint Server 2013

设置 Excel Services 应用程序的全局属性。

语法

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

说明

cmdlet 更改 Set-ExcelServiceApplication Excel Services 应用程序的全局运行时属性。 使用此 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应用程序的后端应用程序服务器上一次打开不超过 10 个会话。

--------------示例 2--------------

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

本示例将计算机上内存的最大专用字节数设置为 -1，该值指示Excel Services应用程序将消耗 50% 的可用内存资源。

参数

-AssignmentCollection

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。 如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

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

-CrossDomainAccessAllowed

指定驻留在其他 HTTP 域中的 Web 部件或页面可以请求和呈现受信任工作簿及数据连接文件。

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

-EncryptedUserConnectionRequired

要求在最终用户和运行 Excel Services 应用程序的服务器之间使用加密。 此设置的作用范围为逻辑服务器。 默认值为 None。

键入的值必须为以下项之一：None 或 Connection。

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

-FileAccessMethod

指定应用程序Excel Services检索文件的身份验证方法。 UseFileAccessAccount 指定所有工作簿始终使用运行 Excel Services Application 的服务帐户的凭据。 UseImpersonation 指定 Excel Services Application 以发出请求的用户身份检索工作簿文件。 默认值为 UseImpersonation。

键入的值必须为以下项之一：UseImpersonation 或 UseFileAccessAccount。

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

-Identity

指定要更新的 SPExcelServiceApplication 对象。

类型必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh;场中Excel Services应用程序 Web 服务应用程序的有效名称 (例如 MyExcelService1) ;或有效 SPExcelServiceApplication 对象的实例。

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

-MemoryCacheThreshold

指定可以分配给非活动对象的最大专用字节所占的百分比。 如果超过内存缓存阈值，则将释放当前未使用的缓存对象。 将该值设置为 0 将禁止缓存非活动对象。 默认值为 90。

键入的值必须为 0 到 95 之间的整数。

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

-PrivateBytesMax

指定 Excel Services Application 使用的最大专用字节（以兆字节为单位）。 如果设置为 -1，则最大专用字节数默认为计算机上的物理内存的 50%。 有效值包括 -1（无限制）以及任何正整数。 默认值为 -1。

键入的值必须为 -1 或任何正整数。

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

-SiteCollectionAnonymousSessionsMax

指定每个网站集允许的最大匿名会话数。 值 0 指定不允许匿名会话。 有效值包括 -1（无限制）、0（禁用此设置）或任何正整数。 默认值为 25。

键入的值必须为 -1、0 或任何正整数。

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

-ThrottleAccessViolationsPerSiteCollection

指定如果工作簿在 Excel Services 应用程序上导致访问冲突错误，则会阻止来自该工作簿网站集的所有文件在指定时间段内加载， (以秒为单位) 。 该网站集上的文件的现有会话不受影响。 有效值包括 0（禁用该设置）以及介于 1 到 2073600 秒（24 天）之间的值。 默认值为 0。

键入的值必须为 0 到 2073600 之间的整数。

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

-UnattendedAccountApplicationId

指定用于从 UnattendedAccountSecureServiceAppName 参数指定的安全存储服务中查找无人参与服务帐户凭据的应用程序 ID。 设置此参数并发生特定错误情况时，将联系安全存储服务。 有效值为最多含 256 个字符的字母数字字符串。 默认值为空字符串。

键入的值必须为有效的字母数字字符串；例如 UnattendedServiceAccountID。

无人参与帐户是一个所有工作簿都可用其来刷新数据的帐户。 当工作簿连接为身份验证指定 None 时，或使用任何非 Windows 凭据刷新数据时，需要使用无人参与帐户。

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

-UnusedObjectAgeMax

指定会话中当前未使用的对象可以保留在内存缓存中的最长时间（以分钟为单位）。 有效值包括 -1（无最大设置）以及介于 1 到 34560 分钟（24 天）之间的正整数。 默认值为 -1。

键入的值必须为 -1 或介于 1 到 34560 之间的某个整数。

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