How to Uninstall an App in SharePoint 2013 Using PowerShell

After you have successfully configured an environment for apps in SharePoint 2013, you can add apps from the SharePoint Store to a site and install apps in SharePoint 2013 using PowerShell. So what happens if you decide that you no longer need or want an existing app on your site? In this article, we’ll show you how to uninstall SharePoint 2013 apps with PowerShell.

Before you begin, make sure that the user running the Windows PowerShell cmdlets has the following memberships on all databases that you will be using:

  • db_securityadmin
  • db_owner

In addition, the user will also need to be a member of the Site Collection Administrators group or Site Owners group on the site collection where the app is installed.

In this example, we will be uninstalling the existing app “Bamboo.Apps.QuickAdd.”

Run the following command:

$instances = Get-SPAppInstance -Web <URL>

Please note that:

  • URL refers to the URL for the site collection or subsite where the app is located.

Per the above, in this example, we’ll be typing the following command line: $instances = Get-SPAppInstance -Web “http://chauo15:81/sites/sharepoint”

Press Enter

Next, run the following command to get the details of the app which you want to uninstall:

$instance $instances | where {$_.Title -eq ‘<AppTitle>‘}

Please note that:

  • App Title refers to the title of the app which you wish to uninstall.

Per the above, in this example, we’ll be typing the following command line: $instance = $instances | Where {$_.Title -eq “Bamboo.Apps.QuickAdd”}

Press Enter

Run the following command to uninstall after you get the app details:

Uninstall-SPAppInstance -Identity $instance

When asked “Are you sure you want to perform this action?,” type Y to uninstall the app.

Return to your Site Contents page.  You will no longer see your app listed.

Please note that when you’re only removing an app from a SharePoint site, you can integrate the first two commands listed above into a single command:

$instance = Get-SPAppInstance -Web <URL> | Where-Object {$_.Title -eq ‘<AppTitle>‘}

For example: $instance = Get-SPAppInstance -Web “http://chauo15:81/sites/sharepoint” | Where-Object {$_.Title -eq “Bamboo.Apps.QuickAdd”}