Grant-SPOSiteDesignRights

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell
Applies to:
SharePoint Online

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