Uninstall

Uninstall

There is no fully automatic uninstallation process. Remove the solution in the order below.

Back up first. Deleting the Azure resources destroys the analytics SQL database and all collected data. Take a backup (or export) of the database first if you may need the data.

1. Stop the importers

Stop the App Service (or at least its web-jobs) so no further data is imported while you tear things down. You can do this from the App Service in the Azure portal, or simply delete the resource group in step 3.

2. Remove the SharePoint web components

Only needed if you deployed the SharePoint web-tracking / SPFx components.

• Unregister the web-tracker from the deployed SharePoint sites:

  .\InstallSPOInsightsTracker.PnP.ps1 -ConfigFileName "MyConfig.json" -UninstallOnly

  The configuration file is the same one created to deploy to the sites — see Deploy AITracker via PowerShell.

• Uninstall the SPFx solution from the tenant App Catalog:

  

3. Delete the Azure resources

The installer creates everything in a single resource group. Deleting that resource group removes all of the solution's Azure resources in one step: App Service, SQL Server & database, Redis, Service Bus, Key Vault, Storage, Application Insights, Log Analytics, the Automation account, and Cognitive Services (where deployed). It also removes the Azure RBAC role assignments that were granted on the group.

Delete the resource group from the Azure portal (or az group delete -n <resource-group>).

4. Remove the Entra ID app registrations

If they are no longer needed elsewhere, delete the two Azure AD app registrations created for the solution (the runtime and installer service principals). See Prerequisites → Solution service principals.