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 at least a SharePoint Online 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 [email protected]Example 2 sets [email protected] 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 |