Set-SPOSiteGroup

Updates the SharePoint Online owner and permission levels on a group inside a site collection.

Syntax

Set-SPOSiteGroup
   -Identity <String>
   [-Name <String>]
   [-Owner <String>]
   [-PermissionLevelsToAdd <String[]>]
   [-PermissionLevelsToRemove <String[]>]
   -Site <SpoSitePipeBind>
   [<CommonParameters>]

Description

You must be a SharePoint Online administrator or Global Administrator and be a site collection administrator to run the Set-SPOSiteGroup cmdlet.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

Examples

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

Set-SPOSiteGroup -Site https://contoso.sharepoint.com/sites/siteA -Identity "ProjectViewers" -PermissionLevelsToRemove "Full Control" -PermissionLevelsToAdd "View Only"

Example 1 changes permission level of the ProjectViewers group inside site collection https://contoso.sharepoint.com/sites/siteA from Full Control to View Only.

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

Set-SPOSiteGroup -Site https://contoso.sharepoint.com -Identity "ProjectViewers" -Owner Melissa.kerr@contoso.com

Example 2 sets Melissa.kerr@contoso.com as the owner of the ProjectViewers group.

Parameters

-Identity

Specifies the name of the group.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Name

Specifies the new name of the group.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Owner

Specifies the owner (individual or a security group) of the group to be created.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-PermissionLevelsToAdd

Specifies the permission levels to grant to the group.

Note

Permission levels are defined by SharePoint Online administrators from SharePoint Online Administration Center.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-PermissionLevelsToRemove

Specifies the permission levels to remove from the group.

Note

Permission levels are defined by SharePoint Online administrators from SharePoint Online Administration Center.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Site

Specifies the site collection the group belongs to.

Type:SpoSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online