New-PowerPivotEngineServiceInstance cmdlet

将 SQL Server Analysis Services 的新实例添加到应用程序服务器。

语法

New-PowerPivotEngineServiceInstance [-ParentService <PowerPivotEngineServicePipeBind>] [-EngineServiceInstanceName <string>] [-Provision <switch>] [-EnableQueryMode <switch>] [-EnableProcessingMode <switch>] [-MaximumParallelRefreshJobs <Ushort>] [-MaximumDiskcache <Ushort>] [-LastAccessedTime <Ushort>] [-WarnOnLowMemory <Ushort>] [-MaximumConnectionLimit <Ushort>] [-WarnOnLowCPUMachine <Ushort>] [-WarnOnLowCPUOlapService <Ushort>] [-WarnOnLowDisk <Ushort>] [-DataCollectionInterval <Ushort>] [<CommonParameters>]

说明

New-PowerPivotEngineServiceInstance cmdlet 向 SharePoint 注册 SQL Server Analysis Services。 在 SharePoint 中添加 PowerPivotEngineService 的新实例是在本地应用程序服务器上部署 PowerPivot for SharePoint 所必需的。 您必须在使用 SQL Server 安装程序在本地计算机上安装 SQL Server Analysis Services 的实例后执行此步骤。 此步骤将 SQL Server Analysis Services 添加到 SharePoint 管理中心中的“管理服务器上的服务”列表。

Analysis Services 基于在 SQL Server 安装期间提供的服务帐户运行。 在您创建新的 PowerPivotEngineServiceInstance 对象时,该服务帐户将作为托管帐户注册。

参数

-ParentService <PowerPivotEngineServicePipeBind>

指定场中 PowerPivot 引擎服务父对象的 GUID。 在此版本中,仅允许一个父对象。 使用 Get PowerPivotEngineService 可以获取父服务的 GUID。

必需?

false

位置?

0

默认值

接受管道输入?

true

接受通配符?

false

-EngineServiceInstanceName <string>

指定标识此对象的名称。 您可以在自定义脚本或函数中使用该对象的名称。

必需?

false

位置?

1

默认值

接受管道输入?

false

接受通配符?

false

-Provision <switch>

使服务在 SharePoint 上可用。 有效值为 $true 或 $false。

必需?

false

位置?

所指定位置

默认值

接受管道输入?

false

接受通配符?

false

-EnableQueryMode <switch>

指定服务器是否接受对 PowerPivot 数据的按需查询请求。 默认值为 true。 如果您关闭查询模式,服务器将只处理数据刷新作业。 默认情况下,EnableQueryMode 和 EnableProcessingMode 都启用,这允许服务器处理针对按需查询以及数据刷新处理的请求。

必需?

false

位置?

所指定位置

默认值

接受管道输入?

false

接受通配符?

false

-EnableProcessingMode <switch>

指定服务器是否接受数据刷新请求。 默认值为 true。 如果您关闭数据刷新处理,服务器将只处理按需查询。 默认情况下,EnableQueryMode 和 EnableProcessingMode 都启用,这允许服务器处理针对按需查询以及数据刷新处理的请求。

必需?

false

位置?

所指定位置

默认值

接受管道输入?

false

接受通配符?

false

-MaximumParallelRefreshJobs <Ushort>

指定可在服务器上同时运行的数据刷新作业数。 默认值为每个 CPU 1 个作业。 如果服务器具有 2 个处理器,则可以将此值设置为 2。

必需?

false

位置?

所指定位置

默认值

1

接受管道输入?

false

接受通配符?

false

-MaximumDiskcache <Ushort>

指定为缓存 PowerPivot 数据而分配的磁盘空间量。 在数据加载到内存中时在第一次请求时缓存 PowerPivot 数据。 甚至数据不再被主动使用后也保留在磁盘上,以便支持对相同数据的以后的连接请求。 如果在 PowerPivot 服务应用程序对象上的 MemoryDatabaseHoldLimit 参数指定的天数中没有任何人请求该数据,则最终将会删除该数据。

必需?

false

位置?

所指定位置

默认值

0

接受管道输入?

false

接受通配符?

false

-LastAccessedTime <Ushort>

指定在磁盘空间达到上限时用于清空缓存的上次使用的条件。 按照您定义的每小时间隔在上次访问的所有缓存的文件将立即从文件系统中删除。 默认值为 4 小时。 如果达到该最大磁盘空间限制,则 4 小时或更长时间未处于活动状态的所有数据库都将从文件系统中删除。 处于非活动状态但仍在内存中的数据库将被卸载,然后从文件系统中删除。

必需?

false

位置?

所指定位置

默认值

4

接受管道输入?

false

接受通配符?

false

-WarnOnLowMemory <Ushort>

指定服务器始终不应使用的可用内存的百分比。 在 SharePoint 应用程序服务器上,SQL Server Analysis Services 实例应该始终保留总是不会使用的少量内存。 因为对于其主要操作而言服务器是受到内存限制的,所以,令服务器在运行时永远不会达到其上限可使服务器保持最佳运行状态。

默认值为 5%。 如果保留的内存低于这一数额,一个运行状况规则将会触发,警告服务器内存不足。 该 5% 的未使用内存是按占分配给 Analysis Services 的内存的百分比计算的。 例如,如果您具有 200 GB 的总内存,并且 Analysis Services 被分配了总内存的 80%(也就是 160 GB),则 5% 的未使用内存为 160 GB 的 5%(也就是 8 GB)。

必需?

false

位置?

所指定位置

默认值

5

接受管道输入?

false

接受通配符?

false

-MaximumConnectionLimit <Ushort>

指定用户连接数的上限,超过该上限服务器即被视为具有过多连接。 超过此上限将会触发一个运行状况规则,指示服务器正在处理的连接数超过了其应该支持的连接数。 默认值为 100。 有效值为 1 至 500。

必需?

false

位置?

所指定位置

默认值

100

接受管道输入?

false

接受通配符?

false

-WarnOnLowCPUMachine <Ushort>

设置一个 CPU 阈值,达到此阈值将触发一个运行状况规则,警告物理服务器正在 CPU 资源不足的情况下运行。 此值是以百分比表示的。 默认值为 90%。 如果计算机上的 CPU 资源在超过 4 小时的时段内保持为或高于 90%(通过 DataCollectionInterval 参数指定),将触发此运行状况规则。

必需?

false

位置?

所指定位置

默认值

90

接受管道输入?

false

接受通配符?

false

-WarnOnLowCPUOlapService <Ushort>

设置一个 CPU 阈值,达到此阈值将触发一个运行状况规则,警告 SQL Server Analysis Services 实例具有资源不足的 CPU。 此值是以百分比表示的。 默认值为 80%。 如果 Analysis Services 服务器进程 (msmdsrv.exe) 的 CPU 资源占用率在超过 4 小时的时段内保持为或高于 80%(通过 DataCollectionInterval 参数指定),将触发此运行状况规则。

必需?

false

位置?

所指定位置

默认值

80

接受管道输入?

false

接受通配符?

false

-WarnOnLowDisk <Ushort>

指定可用磁盘空间百分比,一旦低于该百分比,服务器将被视为用于缓存数据的空间不足。 当可用磁盘空间低于此值时,将触发一个运行状况规则,指示磁盘空间不足。 默认值为 5。 有效值为 1 到 99。

必需?

false

位置?

所指定位置

默认值

5

接受管道输入?

false

接受通配符?

false

-DataCollectionInterval <Ushort>

指定用于计算触发运行状况规则所使用的数字的数据收集期间。 虽然会对系统进行持续监视,但会使用在预定义间隔内生成的数据来计算用于触发运行状况规则警告的阈值。 默认间隔为 4 小时。 服务器将检索在前 4 个小时内收集到的系统和使用率数据,以计算用户连接数、磁盘空间使用率以及 CPU 与内存使用率。

必需?

false

位置?

所指定位置

默认值

4

接受管道输入?

false

接受通配符?

false

<CommonParameters>

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

输入和输出

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

输入

无。

输出

无。

示例 1

C:\PS>New-PowerPivotEngineServiceInstance -provision:$true

向 SharePoint 注册 SQL Server Analysis Services (PowerPivot) 的本地实例。