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.