Commands › SharePoint Online

Grant-SPOSiteDesignRights

SharePoint Online Microsoft.Online.SharePoint.PowerShell Grant-*

Used to apply permissions to a set of users or a security group, effectively scoping the visibility of the site design in the UX. They start off public, but after you set permissions, only those groups or users with permissions can access the site design.

Quick start script

# Grant-SPOSiteDesignRights — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com

# 2. Run and inspect
Grant-SPOSiteDesignRights -Identity <SPOSiteDesignPipeBind> -Principals <String[]> -Rights <SPOSiteDesignPrincipalRights> | Format-List

# 3. Export for evidence / drift tracking
Grant-SPOSiteDesignRights | Export-Clixml .\SPOSiteDesignRights-$(Get-Date -Format yyyyMMdd).xml

Syntax

Grant-SPOSiteDesignRights [-Identity] <SPOSiteDesignPipeBind> -Principals <String[]>
 -Rights <SPOSiteDesignPrincipalRights> [<CommonParameters>]

Parameters (3)

Parameter	Type	Required	What it controls
-Identity	SPOSiteDesignPipeBind	yes	The ID of the site design to get scoping information.
-Principals	String[]	yes	One or more principles to add permissions for.
-Rights	SPOSiteDesignPrincipalRights	yes	Always set to the value View. Any user or group with view permissions can view and use the site design.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.