Skip to content

Latest commit

 

History

History
98 lines (72 loc) · 2.39 KB

Uninstall-PnPAppInstance.md

File metadata and controls

98 lines (72 loc) · 2.39 KB
external help file applicable schema
SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
2.0.0

Uninstall-PnPAppInstance

SYNOPSIS

Removes an app from a site

SYNTAX

Uninstall-PnPAppInstance -Identity <AppPipeBind>
                         [-Force [<SwitchParameter>]]
                         [-Web <WebPipeBind>]
                         [-Connection <SPOnlineConnection>]

DESCRIPTION

Removes an add-in/app that has been installed to a site.

EXAMPLES

------------------EXAMPLE 1------------------

PS:> Uninstall-PnPAppInstance -Identity $appinstance

Uninstalls the app instance which was retrieved with the command Get-PnPAppInstance

------------------EXAMPLE 2------------------

PS:> Uninstall-PnPAppInstance -Identity 99a00f6e-fb81-4dc7-8eac-e09c6f9132fe

Uninstalls the app instance with the ID '99a00f6e-fb81-4dc7-8eac-e09c6f9132fe'

------------------EXAMPLE 3------------------

PS:> Uninstall-PnPAppInstance -Identity 99a00f6e-fb81-4dc7-8eac-e09c6f9132fe -force

Uninstalls the app instance with the ID '99a00f6e-fb81-4dc7-8eac-e09c6f9132fe' and do not ask for confirmation

PARAMETERS

-Force

Do not ask for confirmation.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Identity

Appinstance or Id of the addin to remove.

Type: AppPipeBind
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: True

-Connection

Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: SPOnlineConnection
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type: WebPipeBind
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

RELATED LINKS

SharePoint Developer Patterns and Practices