Skip to content

Latest commit

 

History

History
168 lines (124 loc) · 4.27 KB

File metadata and controls

168 lines (124 loc) · 4.27 KB
external help file sharepointonline.xml
Module Name Microsoft.Online.SharePoint.PowerShell
online version https://learn.microsoft.com/powershell/module/sharepoint-online/set-spositegroup
applicable SharePoint Online
title Set-SPOSiteGroup
schema 2.0.0
author trent-green
ms.author trgreen
ms.reviewer

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

INPUTS

OUTPUTS

NOTES

RELATED LINKS

Getting started with SharePoint Online Management Shell

Get-SPOSiteGroup