Grant-SPOSiteDesignRights
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.
Syntax
Grant-SPOSiteDesignRights
[-Identity] <SPOSiteDesignPipeBind>
-Principals <string[]>
-Rights {View}
[<CommonParameters>]
Description
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.
Examples
Example 1
This example shows how to grant view rights on a site design to Nestor (a user at the fictional Contoso site).
Grant-SPOSiteDesignRights `
-Identity 44252d09-62c4-4913-9eb0-a2a8b8d7f863 `
-Principals "nestorw@contoso.onmicrosoft.com" `
-Rights View
Parameters
-Identity
The ID of the site design to get scoping information.
Type: | SPOSiteDesignPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Online |
-Principals
One or more principles to add permissions for.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Online |
-Rights
Always set to the value View. Any user or group with view permissions can view and use the site design.
Type: | SPOSiteDesignPrincipalRights |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Online |