Issue: Deploying Application Customizer Using PnP PowerShell

[GeorgiaGit]

I am working on automating the deployment of a Microsoft Clarity Application Customizer to specific SharePoint Online sites using PnP PowerShell. The script uploads the .sppkg package to the Site Collection App Catalog, installs the app and adds the Custom Action to the application customizer. However, I am encountering some odd behavior that is preventing this from working end to end.

Expected behavior

Web Level feature is activated on Install-PnPApp -Identity $uploadedApp.Id -Scope Site -ErrorAction Stop and the clarityID property is set with the appropriate value in the Application Customizer allowing data to be collected within Microsoft Clarity.

Actual behavior

Web Level feature is not activated on Install-PnPApp -Identity $uploadedApp.Id -Scope Site -ErrorAction Stop
Tje Application Customizer property is being set However NO data is being collected within Microsoft Clarity.

Adding it Manually

If I add the application to the site manually from the site contents and then run
Add-PnPCustomAction -ClientSideComponentId $clientSideComponentId
-Name "Microsoft Clarity"
-Title "Microsoft Clarity"
-Location ClientSideExtension.ApplicationCustomizer
-ClientSideComponentProperties $clientSideComponentProperties
-Scope Site

✅ it works.

If I run a check to see the availabe Application Customizers
$customActions = Get-PnPApplicationCustomizer
$customActions | Format-Table -Property Name, Id, ClientSideComponentId, ClientSideComponentProperties

I see two entries

The first entry is created when I install the app through the site contents (web scope).
The second entry is created when I run Add-PnPCustomAction above (site scope).

Steps to reproduce behavior

$appPackagePath = "C:\Clarity\clarity.sppkg"
$uploadedApp = Add-PnPApp -Path $appPackagePath -Scope Site -Overwrite -Publish -ErrorAction Stop

Start-Sleep -Seconds 30 # Adjust the wait time as needed

Install-PnPApp -Identity $uploadedApp.Id -Scope Site -ErrorAction Stop

Start-Sleep -Seconds 30 # Adjust the wait time as needed

Add-PnPCustomAction -ClientSideComponentId $clientSideComponentId
-Name "Microsoft Clarity"
-Title "Microsoft Clarity"
-Location ClientSideExtension.ApplicationCustomizer
-ClientSideComponentProperties $clientSideComponentProperties
-Scope Site

❌doesn't work.

If I run a check to see the availabe Application Customizers
$customActions = Get-PnPApplicationCustomizer
$customActions | Format-Table -Property Name, Id, ClientSideComponentId, ClientSideComponentProperties

I only see one entry (site scope)

Any assistance or advice would be greatly appreciated.

What is the version of the Cmdlet module you are running?
3.1.0

Which operating system/environment are you running PnP PowerShell on?

• Windows
• Linux
• MacOS
• Azure Cloud Shell
• Azure Functions
• Other : please specify

[GeorgiaGit]

This was performed on a Microsoft Dev tenant using the Global Admin account to call Connect-PnPOnline
Connect-PnPOnline -Url $siteUrl -Interactive -ClientId $clientID

I assumed being a global admin and the App registration delegated permisions to Sites.FullControl would work.

It did not.

Problem Solved

I created a new app registration using:
Register-PnPAzureADApp -ApplicationName "PnP Online" -Tenant xxxxx.onmicrosoft.com -Store CurrentUser

Connected using the App Registration only:
Connect-PnPOnline -Url $siteUrl -ClientId $clientID -ThumbPrint $thumbPrint -Tenant $tenant

Ran the code again and Application Customizer deployed correctly and began communicating with Clarity.

Thanks,
Andrew