Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
171 lines (122 sloc) 4.03 KB
external help file applicable title schema author ms.author ms.reviewer
sharepointonline.xml
SharePoint Online
Set-SPOSiteGroup
2.0.0
trent-green
trgreen

Set-SPOSiteGroup

SYNOPSIS

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 global administrator and 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 https://go.microsoft.com/fwlink/p/?LinkId=251832 (https://go.microsoft.com/fwlink/p/?LinkId=251832).

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
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Specifies the new name of the group.

Type: String
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Owner

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

Type: String
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PermissionLevelsToAdd

Specifies the permission levels to grant to the group.

[!NOTE] Permission levels are defined by SharePoint Online global administrators from SharePoint Online Administration Center.

Type: String[]
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PermissionLevelsToRemove

Specifies the permission levels to remove from the group.

[!NOTE] Permission levels are defined by SharePoint Online global administrators from SharePoint Online Administration Center.

Type: String[]
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Site

Specifies the site collection the group belongs to.

Type: SpoSitePipeBind
Parameter Sets: (All)
Aliases: 
Applicable: SharePoint Online

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Getting started with SharePoint Online Management Shell

Get-SPOSiteGroup

You can’t perform that action at this time.