Remove-PowerPivotSystemServiceInstance cmdlet
Removes a PowerPivot System Service instance from the farm.
Syntax
Remove-PowerPivotSystemServiceInstance [-Confirm <switch>] [-DeleteLocal <switch>] [-Identity <PowerPivotMidTierServiceInstancePipeBind>] [<CommonParameters>]
Description
The Remove-PowerPivotSystemServiceInstance cmdlet removes instance information about PowerPivot System Service from the farm. It does not remove the program files. To permanently remove the program files, you must uninstall them.
If you remove PowerPivot System Service, be sure to also run Remove-PowerPivotEngineServiceInstance to remove the associated Analysis Services instance, followed by Remove-PowerPivotServiceApplication to delete any PowerPivotservice applications. The service applications will no longer run once theservices are removed.
To revert this change, you can run New-PowerPivotSystemServiceInstance -Provision:$true to re-enable instance information.
Parameters
-Identity <PowerPivotMidTierServiceInstancePipeBind>
Specifies the GUID of the PowerPivot System Service instance you want to remove. There is one service instance on each application server that has an installation of PowerPivot for SharePoint.
Required? |
false |
Position? |
0 |
Default value |
|
Accept pipeline input? |
true |
Accept wildcard characters? |
false |
-DeleteLocal <switch>
Deletes the instance of PowerPivot System Service that is installed on the local machine, allowing you to remove the instance without having to specify an object identity.
Required? |
false |
Position? |
named |
Default value |
|
Accept pipeline input? |
false |
Accept wildcard characters? |
false |
-Confirm <switch>
Prompts you for confirmation before executing the command. This value is enabled by default. To bypass the confirmation response in a command, specify Confirm:$false on the command.
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>Remove-PowerPivotSystemServiceInstance -deletelocal
This example shows how to remove the instance of PowerPivot System Service that runs on the local application server.
Example 2
C:\PS>Remove-PowerPivotSystemServiceInstance -identity 1234567-890a-bcde-fghijklmn
This example shows how to delete a specific PowerPivot System Service based on its identity.