New-PowerPivotSystemServiceInstance cmdlet

Article
04/01/2012

Adds a new instance of PowerPivot System Service to an application server.

Syntax

New-PowerPivotSystemServiceInstance [[-ParentService] <PowerPivotMidTierServicePipeBind>] [-SystemServiceInstanceName <string>] [-Provision] [<CommonParameters>]

Description

The New-PowerPivotSystemServiceInstance cmdlet provisions a new PowerPivotSystemService object at the farm-level after you have used SQL Server Setup to install PowerPivot for SharePoint on the local application server. You can only provision one service instance on each application server. If the service is already provisioned, you cannot run this cmdlet.

Parameters

-ParentService <PowerPivotMidTierServicePipeBind>

Specifies the GUID of the PowerPivot System Service parent object in the farm. In this release, there is only one parent object allowed. You can use Get-PowerPivotSystemService to return the service object or its GUID.

Required?	false
Position?	0
Default value
Accept pipeline input?	true
Accept wildcard characters?	false

-SystemServiceInstanceName <string>

Specifies a name that identifies this object.

Required?	false
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

Provision [<SwitchParameter>]

Makes the service available on SharePoint. Valid values are $true or $false.

Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer and OutVariable. For more information, see About_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs	None.
Outputs	None.

Example 1

C:\PS>New-PowerPivotSystemServiceInstance -Provision:$true

This example shows the most common form of the cmdlet. It registers the PowerPivot System Service on the local application server with the farm.

Example 2

C:\PS>New-PowerPivotSystemServiceInstance -SystemServiceInstanceName "MyPSSInstance" -provision:$false

This example names the PowerPivot System Service instance, but without provisioning it. If you do not provide a name, the default name, SQL Server Analysis Services System Service Instance, is used instead. Creating a custom name for the service is optional. You might name the service to support test scenarios, or if you have a custom tool or script that provisions the instance in a later step.