This page needs some major updating

[AndyTuke]

• The screenshots are quite out of date for Azure now.
• The first PowerShell command Register-PnPAzureADApp creates a certificate, but no where in the rest of the page does it tell you what to do with it.
• When you do have the certificate and try to upload it in the Function App under 'Bring your own certificate' the portal insists on the cert having a password which the cmdlet doesn't implement as documented
• Creating the function app tells you to select the storage account, not all subscriptions seem to show this option so it would be good to have the pre requisites listed of exactly what Azure sub is going to be required

Generally, the article is not going to help some one do this work. I've been doing 365 consultancy for 10 years, PowerShell for longer, I have a fairly basic Azure background and after 24 hours don't feel I have any hope of getting this to work using just this page. I'm having to search pretty much every step to find out what I really need to be doing

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: c58783cb-5827-81c0-c696-9b4fb299694f
• Version Independent ID: fa4deb1f-144b-8ac2-ff2b-e27232660f1c
• Content: Calling the PnP provisioning engine from a site script
• Content Source: docs/declarative-customization/site-design-pnp-provisioning.md
• Service: sharepoint-online
• GitHub Login: @VesaJuvonen
• Microsoft Alias: vesaj

[Ashlesha-MSFT]

Hello @AndyTuke,
Thank you for bringing this issue to our attention. We will look into it and get back to you shortly.

[Ashlesha-MSFT]

@AndyTuke,
Thank you for taking the time to share this detailed feedback. You've brought up several valid points that highlight important usability and documentation gaps in the “Calling the PnP provisioning engine from a site script” article.
I’m going to flag this internally as a DocumentationGap, and will recommend:

• Adding updated portal screenshots and steps.
• Clarifying certificate handling (with password, PFX upload, and alternatives).
• Listing Azure prerequisites more explicitly.
• Including troubleshooting tips and region-based behavior notes.