Set-PowerPivotServiceApplication cmdlet

设置 PowerPivot 服务应用程序的属性。

语法

Set-PowerPivotServiceApplication [-Identity] <SPGeminiServiceApplicationPipeBind> [-AdministrationConnectionPoolSize <int>] [-AllowCustomWindowsCredentials] [-BusinessHoursEndTime <string>] [-BusinessHoursStartTime <string>] [-CachedDatabaseholdLimit <int>] [-Confirm <switch>] [-ConnectionPoolSize <int>] [-ConnectionPoolTimeout <int>] [-DataLoadTimeout <int>] [-DataRefreshFailureThreshold <int>] [-DataRefreshInactiveWorkbooksThreshold <int>] [-DataRefreshMaxHistory <int>] [-HealthBasedAllocation <switch>] [-LoadsToConnectionsRatioCollectionInterval <int>] [-LoadsToConnectionsRatioLimit <int>] [-MemoryDatabaseHoldLimit <int>] [-QueryReportingInterval <int>] [-RoundRobinAllocation <switch>] [-UnattendedAccount <string>] [-UsageDataRetentionPeriod <int>] [-UsageExpectedResponseUpperLimit <int>] [-UsageLongResponseUpperLimit <int>] [-UsageQuickResponseUpperLimit <int>] [-UsageTrivialResponseUpperLimit <int>] [-UsageUpdateDayLimit <int>] [<CommonParameters>]

说明

Set-PowerPivotServiceApplication cmdlet 更新场中 PowerPivot 服务应用程序的属性。 Identity 参数是必需的。 您必须提供要更新其属性的服务应用程序的 GUID。

若要验证您所做的更改，请运行以下 cmdlet：Get-PowerPivotServiceApplication -Identity <GUID> | format-list。

参数

-Identity <SPGeminiServiceApplicationPipeBind>

指定要更新的服务应用程序。 该类型必须是有效的 GUID 或有效的 PowerPivot 服务应用程序对象的实例。 您可以使用 Get-PowerPivotServiceApplication 返回对象的实例。

必需？	true
位置？	0
默认值
接受管道输入？	true
接受通配符？	false

-AdministrationConnectionPoolSize <int>

指定连接池中为与 Analysis Services 的 PowerPivot 服务连接而创建的打开的连接数目。 每个 PowerPivot 服务实例都打开与同一计算机上的 Analysis Services 实例的单独管理连接。 PowerPivot 服务创建一个单独的池以便出于检查空闲连接和监视服务器运行状况的目的而重用管理连接。 默认值为 200 个连接。 有效值为 -1（无限制）、0（禁用管理连接池）或 1 到 100。 如果您选择 0，将重新创建每个连接。

必需？	false
位置？	所指定位置
默认值	200
接受管道输入？	false
接受通配符？	false

-AllowCustomWindowsCredentials [<SwitchParameter>]

指定计划所有者是否可以输入任意 Windows 凭据以便运行数据刷新计划。 如果您选中此复选框，PowerPivot 服务应用程序将为每组存储凭据都创建和管理目标应用程序。 默认设置为 true。 若要关闭此功能，请设置 AllowCustomWindowsCredentials:$false。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-BusinessHoursEndTime <string>

指定用于定义工作日的小时范围的结束时间。 数据刷新计划可以在下班后运行，以便选取在正常工作时间中生成的事务数据。 默认值为 8:00 p.m. 有效值在引号中指定，并且采用 a.m. 或 p.m. 时钟时间（例如，"08:00PM"）。 小时必须介于 1 和 12 之间。 分钟必须介于 1 和 59 之间。

若要指定工作日的完整小时范围，必须一起设置 BusinessHoursStartTime 和 BusinessHoursEndTime。 这两个参数定义构成工作日的小时间隔。

必需？	false
位置？	所指定位置
默认值	8 PM
接受管道输入？	false
接受通配符？	false

-BusinessHoursStartTime <string>

指定用于定义工作日的小时范围的开始时间。 数据刷新计划可以在下班后运行，以便选取在正常工作时间中生成的事务数据。 默认值为 4:00 a.m. 有效值在引号中指定，并且采用 a.m. 或 p.m. 时钟时间（例如，"04:00AM"）。 小时必须介于 1 和 12 之间。 分钟必须介于 1 和 59 之间。

若要指定工作日的完整小时范围，必须一起设置 BusinessHoursStartTime 和 BusinessHoursEndTime。 这两个参数定义构成工作日的小时间隔。

必需？	false
位置？	所指定位置
默认值	4 AM
接受管道输入？	false
接受通配符？	false

-CachedDatabaseholdLimit <int>

指定非活动数据库在文件系统上保留多少小时后，将会从内存中卸载。 默认值为 120 小时。 清除作业将使用此设置来确定要删除的文件。 168 小时（48 小时在内存中，120 小时在缓存中）处于非活动状态的所有 PowerPivot 数据库都将由清除作业从磁盘中删除。

必需？	false
位置？	所指定位置
默认值	120
接受管道输入？	false
接受通配符？	false

-Confirm <switch>

在执行命令前提示您进行确认。 默认情况下将启用该值。 若要在命令中跳过确认响应，请在命令中指定 Confirm:$false。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-ConnectionPoolSize <int>

指定 PowerPivot 服务将在单独的连接池中为各 SharePoint 用户、PowerPivot 数据集和版本组合创建的空闲连接的最大数目。 默认值为 1000 个空闲连接。 有效值为 -1（无限制）、0（禁用用户连接池）或 1 到 10000。 这些连接池使服务能够更有效地支持与同一用户的相同只读数据的持续连接。 如果您禁用了连接池，将重新创建每个连接。 请注意，更改对连接池大小的限制（包括将其设置为 0）不会导致删除连接。 在连接到数据时，连接池存在以便减少等待时间。 PowerPivot 服务将永远不会拒绝基于连接池设置的连接。

必需？	false
位置？	所指定位置
默认值	1000
接受管道输入？	false
接受通配符？	false

-ConnectionPoolTimeout <int>

指定空闲数据连接将保持打开状态的分钟数。 默认值为 1800 秒（或 30 分钟）。 在此期间中，对于来自相同 PowerPivot 数据的同一 SharePoint 用户的只读请求，PowerPivot 服务应用程序将重复使用空闲数据连接。 如果在指定的时段中没有收到针对该数据的进一步的请求，则从池中删除该连接。 有效值为 1 至 3600 秒。

必需？	false
位置？	所指定位置
默认值	1800
接受管道输入？	false
接受通配符？	false

-DataLoadTimeout <int>

指定 PowerPivot 服务应用程序等待来自它将加载数据请求转发到的 SQL Server Analysis Services (PowerPivot) 实例的响应的时间长度。 因为非常大的数据集需要花时间在线路上移动，所以必须确保 PowerPivot 服务实例有充裕的时间检索 Excel 工作簿并将 PowerPivot 数据移到 Analysis Services 实例以便进行查询处理。 默认值为 1800 秒（或 30 分钟）。 有效值为 1 到 3600 秒。

必需？	false
位置？	所指定位置
默认值	1800
接受管道输入？	false
接受通配符？	false

-DataRefreshFailureThreshold <int>

指定经过多少次连续失败，将会禁用计划。 默认值为 10。 您还可以输入 0，永远不会由于刷新失败而禁用计划。

必需？	false
位置？	所指定位置
默认值	10
接受管道输入？	false
接受通配符？	false

-DataRefreshInactiveWorkbooksThreshold <int>

指定经过了多少个数据刷新周期后就将禁用计划，或者输入 0，以便永远不会由于不活动而禁用计划。 默认值为 10 个周期。

如果对于多个数据刷新周期都没有连接事件，则认为工作簿不活动。 每次触发数据刷新操作（通过计划或“立即运行”操作触发）时都会对数据刷新周期计数，而与该操作是成功还是失败无关。 如果经过了一定数目的周期（默认为 10）且没有针对该工作簿的连接请求，则数据刷新计划将由于不活动而被禁用。

必需？	false
位置？	所指定位置
默认值	10
接受管道输入？	false
接受通配符？	false

-DataRefreshMaxHistory <int>

指定保留数据刷新处理的历史记录的时间长度。 此信息显示在为使用数据刷新的每个工作簿保留的数据刷新历史记录页中。 它还出现在 PowerPivot 管理面板中。 默认值为 365 天。

必需？	false
位置？	所指定位置
默认值	365
接受管道输入？	false
接受通配符？	false

-HealthBasedAllocation <switch>

指定基于运行状况的分配算法，该算法将连接请求转发到其 CPU 和内存资源的可用性最高的 PowerPivot for SharePoint 服务器。 这是默认分配算法。 HealthBasedAllocation 和 RoundRobinBasedAllocation 是互斥的。 只能指定其中的一个。 如果您将它们都设置为 false，将使用 HealthBasedAllocation，因为它是默认值。 如果您将它们都设置为 true，将会收到验证错误。 这些参数的语法包括仅输入参数名称，或者输入 parameter:$true 或 parameter:$false。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-LoadsToConnectionsRatioCollectionInterval <int>

指定为计算加载与连接之比而对加载和连接事件进行计数的时间间隔（以小时为单位）。 默认情况下，系统会每 4 小时计算一个新比率。 有效值为 1 至 24。

必需？	false
位置？	所指定位置
默认值	4
接受管道输入？	false
接受通配符？	false

-LoadsToConnectionsRatioLimit <int>

指定加载事件与连接事件的比率，用作服务器运行状况的一个指标。 默认值为 20%。

必需？	false
位置？	所指定位置
默认值	20
接受管道输入？	false
接受通配符？	false

-MemoryDatabaseHoldLimit <int>

指定非活动数据库保留在内存中以便支持针对这些数据的新请求的小时数。 只要您对活动数据库进行查询，该活动数据库就会始终保留在内存中，但在该数据库不再处于活动状态后，系统会将该数据库在内存中再保留一段时间，以防出现针对这些数据的更多请求。 默认值为 48 小时。

必需？	false
位置？	所指定位置
默认值	48
接受管道输入？	false
接受通配符？	false

-QueryReportingInterval <int>

指定在报告前作为使用情况事件收集查询响应统计信息的秒数。 默认值为 300 秒。

必需？	false
位置？	所指定位置
默认值	300
接受管道输入？	false
接受通配符？	false

-RoundRobinAllocation <switch>

指定循环分配算法，该算法将连接请求转发到下一个 PowerPivot for SharePoint 服务器，并且在各可用服务器之间平均交替分配请求，而与服务器负荷无关。 HealthBasedAllocation 和 RoundRobinBasedAllocation 是互斥的。 只能指定其中的一个。 如果您将它们都设置为 false，将使用 HealthBasedAllocation，因为它是默认值。 如果您将它们都设置为 true，将会收到验证错误。 这些参数的语法包括仅输入参数名称，或者输入 parameter:$true 或 parameter:$false。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-UnattendedAccount <string>

指定安全存储区服务应用程序的目标应用程序名称，该应用程序存储一个预定义的帐户以便运行 PowerPivot 数据刷新作业。

必需？	false
位置？	所指定位置
默认值
接受管道输入？	false
接受通配符？	false

-UsageDataRetentionPeriod <int>

指定保留使用情况数据和服务器运行状况统计信息的历史记录的天数。 默认值为 365 天。 将此值设置为 0 将无限期保留所有历史记录。

必需？	false
位置？	所指定位置
默认值	365
接受管道输入？	false
接受通配符？	false

-UsageExpectedResponseUpperLimit <int>

设置定义预期请求-响应交换的上限。 默认值为 3000 毫秒。 出于报告目的，在 1000 到 3000 毫秒之间完成的任何请求都被视为预期响应。

必需？	false
位置？	所指定位置
默认值	3000
接受管道输入？	false
接受通配符？	false

-UsageLongResponseUpperLimit <int>

设置定义长时间运行的请求-响应交换的上限。 上限为 10000 毫秒。 超出此上限的任何请求都属于“超出”类别，因此没有上限。

必需？	false
位置？	所指定位置
默认值	10000
接受管道输入？	false
接受通配符？	false

-UsageQuickResponseUpperLimit <int>

设置定义快速请求-响应交换的上限。 默认值为 1000 毫秒。 在 500 到 1000 毫秒之间完成的任何请求都被视为出于报告目的的快速响应。

必需？	false
位置？	所指定位置
默认值	1000
接受管道输入？	false
接受通配符？	false

-UsageTrivialResponseUpperLimit <int>

指定一个响应时间类别，这些响应时间太短以致出于收集目的不会去考虑。 大多数属于此类别的响应是服务器到服务器的通信。 默认情况下，该值为 500 毫秒。 在 0 到 500 毫秒之间完成的任何请求都是一般请求，并且出于报告目的将被忽略。

必需？	false
位置？	所指定位置
默认值	500
接受管道输入？	false
接受通配符？	false

-UsageUpdateDayLimit <int>

指定触发警告的阈值（天），该警告针对在 PowerPivot 管理面板中刷新报表使用的数据文件失败的情况。 默认情况下，系统会每天更新使用情况数据。 PowerPivot Management Dashboard.xlsx 文件（这是用于管理报告的数据源）将按照相同的计划进行刷新。 如果在一定的天数后未更新该 .xlsx 文件，将触发一个运行状况规则，指示该文件过期。 默认值为 5 天。 有效值为 1 到 30。

必需？	false
位置？	所指定位置
默认值	5
接受管道输入？	false
接受通配符？	false

<CommonParameters>

此 cmdlet 支持以下常用参数：Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer 和 OutVariable。 有关详细信息，请参阅 About_CommonParameters。

输入和输出

输入类型是可以传送到 cmdlet 的对象的类型。 返回类型是 cmdlet 所返回的对象的类型。

输入	无。
输出	无。

示例 1

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -AllowCustomWindowsCredentials:$false -UnattendedAccount "MyTargetApp"

此示例禁用自动创建和管理安全存储区服务目标应用程序以便存储任意 Windows 凭据的数据刷新功能。 它还将 PowerPivot 无人参与的数据刷新帐户设置为预定义的目标应用程序。

使用 Get-powerpivotserviceapplication 可以获取有效的标识。

示例 2

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -HealthBasedAllocation

该示例指定基于运行状况的分配算法，该算法将连接请求转发到其资源的可用性最高的服务器。

使用 Get-powerpivotserviceapplication 可以获取有效的标识。

示例 3

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklmn -BusinessHoursStartTime "07:15AM" -BusinessHoursEndTime "08:00PM"

该示例说明如何设置工作日的开始和结束小时，它们用作计划 PowerPivot 数据刷新的计划选项。 计划可以指定工作时间后的选项，以便在下班后运行数据刷新。

使用 Get-powerpivotserviceapplication 可以获取有效的标识。