Set-PnPListPermission

Sets list permissions

Syntax

Set-PnPListPermission
   -Group <GroupPipeBind>
                        -Identity <ListPipeBind>
                        [-AddRole <String>]
                        [-RemoveRole <String>]
                        [-Web <WebPipeBind>]
                        [-Connection <SPOnlineConnection>]
Set-PnPListPermission
   -User <String>
                        -Identity <ListPipeBind>
                        [-AddRole <String>]
                        [-RemoveRole <String>]
                        [-Web <WebPipeBind>]
                        [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Set-PnPListPermission -Identity 'Documents' -User 'user@contoso.com' -AddRole 'Contribute'

Adds the 'Contribute' permission to the user 'user@contoso.com' for the list 'Documents'

------------------EXAMPLE 2------------------

Set-PnPListPermission -Identity 'Documents' -User 'user@contoso.com' -RemoveRole 'Contribute'

Removes the 'Contribute' permission to the user 'user@contoso.com' for the list 'Documents'

Parameters

-AddRole

The role that must be assigned to the group or user

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Group
Type:GroupPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Identity

The ID or Title of the list.

Type:ListPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-RemoveRole

The role that must be removed from the group or user

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-User
Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False