Contributing PnP PowerShell for deploying Microsoft Clarity

[GeorgiaGit]

Pull Request: New Powershell Script Submission

Description

This pull request adds a new script sample to the repository. The script is designed to This script allows you to setup Microsoft Clarity on a set of site collections using a csv file. This is worthwhile if you are interested in creating multiple projects within Microsoft Clarity.

Features

• Scenario: Deploying the Microsoft Clarity sspkg to muliple sites to track multiple Clarity projects
• Tools Used: PnP PowerShell
• Key Actions:
  • Reads from a list of sites in a csv (exported from SharePoint Admin Center).
  • Deploys the site collection app catalog if not already enabled.
  • Deploys the site collection app catalog if not already enabled.
  • Uploads the .sppkg file to the site collection app catalog.
  • Installs and activates the application customizer.
  • Configures custom action properties with clarityID.

Checklist

• I have completed the README.md file for the script sample.
• I have included any necessary screenshots or assets in the assets folder.
• I have tested the script in my environment to ensure it works as expected.
• I have followed the Contribution Guidance.

Additional Notes

• Clarity Project ID: The script requires a valid clarityID to be passed as a parameter.
• Dependencies: Ensure that PnP PowerShell is installed and updated to the latest version.

---

Thank you for reviewing my contribution! Please let me know if there are any changes or improvements needed.

[GeorgiaGit]

Sorry if I made a mistake here. I see that Don submitted his pull request to pnp:main and I did mine to pnp:dev. Let me know if that wasn't the right thing.

[pkbullock]

Think the dev branch is bit old, I should probably tidy that up. What ill do, is merge this into dev, then create a new PR with the same sample for main. Should be fine to work around this issue, sorry for the confusion, ill take care of it.

[pkbullock]

Thank you @GeorgiaGit - really great sample, ill make the merge from dev to main and then it will be live shortly. 🎉🥳

Have you registered for the PnP Recognition program, your submission will qualify for a badge :-)
Its opt in so please register here: https://pnp.github.io/recognitionprogram

[GeorgiaGit]

Awesome Paul, thanks for the nice comments and accepting the script. I have registered previously.

[GeorgiaGit]

For future contributions, should copying the dev branch be unchecked? Do you want the pull request submitted to pnp:main instead of dev? Appreciate any guidance you can provide.

[pkbullock]

For PnP Script Samples repo, please use the main branch to submit samples, i don't use dev and tempted to remove it. The PnP PowerShell maybe setup differently.