New-PowerPivotSystemServiceInstance cmdlet
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.