Knowledge base / Intranet Builder / Provisioning engine
Provisioning engine & PowerShell
Nine PowerShell scripts over the IntranetBuilder module. A job runs validate › lock › inspect › plan › steps (site, packages, lists, permissions, branding, pages, navigation, extensions, settings, sample content, hub) › verify › release. Requires PowerShell 7.4.6+ and PnP.PowerShell 3.1.0–3.x (validated 3.4.1). Full reference: docs/POWERSHELL.md.
| Script | Changes SharePoint | Purpose |
|---|---|---|
Test-Prerequisites.ps1 | No | Pre-flight: versions, config schema, sign-in, site permissions, catalog and packages, locks, Graph permissions |
Get-DeploymentPlan.ps1 | No | Grouped change plan (+ create, ~ update, = ensure, ! conflict, x error); blocked plans exit 1 |
Install-Intranet.ps1 -Bootstrap | Yes | Once per tenant (SharePoint Admin): deploy 6 packages, create the restricted admin site, install the 3 admin pages, record the mode |
Install-Intranet.ps1 -ConfigurationPath | Yes | Install a Setup Center configuration (release-pinned, SHA-256-checked packages) |
Enable-IntranetModule.ps1 | Yes | Add modules plus dependencies; keeps admin-changed settings; -WhatIf previews |
Disable-IntranetModule.ps1 | Yes | Remove registrations, mark disabled; lists, pages and content are kept |
Update-Intranet.ps1 | Yes | Bring a site to the bundle release (additive); edited pages kept and reported; order: bootstrap › pilot -WhatIf › pilot › test › home › rest |
Test-Intranet.ps1 | No | Health check (same as Health Dashboard); prints the repair and update commands |
Repair-Intranet.ps1 | Yes | Repair lists, pages, navigation, extensions, permissions, branding, settings or the lock; content never removed |
Export-IntranetConfiguration.ps1 | No | Rebuilt deployable configuration from a site's records (a record of the installation and a starting point for another site) |
Jobs, resumption and locks
- Idempotent. Every step inspects the site and changes only what differs; re-running never duplicates lists, pages, links, registrations or samples.
- Resumable. Checkpoints in
.intranet-builder/record completed steps; run the same command again after a failure or Ctrl+C.-Restartre-evaluates everything (use after manual edits). - Verified. After the steps the site is inspected and planned again; remaining work fails the job with
IB8006. - Locked. A job holds the site's deployment lock (renewed every 30 minutes, expiring after 2 hours); a second job stops with
IB1009. Clear a stale lock withRepair-Intranet.ps1 -Resource Lock. - Owned. Created resources are tracked and marked; lists, pages and links the installer did not create are never changed. A page edited after installation is a conflict (rebuildable with
-OverwriteCustomizedPages; history preserved). - Throttling-aware. HTTP 429/503 honor Retry-After with bounded exponential backoff; ETags guard concurrent writes.
Still need help?Our team answers product questions by email, and we can walk you through it on a call.
Open in the full guideContact support