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 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 |