Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

New-SPOSiteGroup

New-SPOSiteGroup

microsoft.online.sharepoint.powershell.dll, microsoft.online.sharepoint.powershell-1.dll

Synopsis

Creates a new group in a SharePoint Online site collection.

Syntax

New-SPOSiteGroup [-Site] [-Group] [-PermissionLevels] [<CommonParameters>]

Detailed Description

A SharePoint 2013 group is a set of individual users. SharePoint 2013 groups enable you to manage sets of users instead of individual users.

You must be a SharePoint Online global administrator and a site collection administrator to run the cmdlet.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at http://go.microsoft.com/fwlink/p/?LinkId=251832 (http://go.microsoft.com/fwlink/p/?LinkId=251832).

Parameters

-Site <SpoSitePipeBind>

Specifies the site collection to add the group to.

Aliases

None

Required?

True

Position

2

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

-Group <String>

Specifies the name of the group to add.

Aliases

None

Required?

True

Position

3

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

-PermissionLevels <String[]>

Specifies the permission levels to grant to the newly created group. It can be any permission level that exists on the site collection on which the group is being created.

Permission levels are defined by SharePoint Online administrators in the SharePoint Online Administration Center.

Aliases

None

Required?

True

Position

5

Default value

Accept pipeline input?

False

Accept wildcard characters?

False

Input Type

Return Type

Notes

None

Examples

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

This example creates a group named Project Leads with the Full Control permission level on the site collection https://contoso.sharepoint.com/sites/siteA.

C:\PS>New-SPOSiteGroup -Site https://contoso.sharepoint.com/sites/siteA -Group "Project Leads" -PermissionLevels "Full Control"

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

This example creates a group named NewGroupName with the Design permission level on the site collection https://contoso.sharepoint.com/sites/marketing.

C:\PS>New-SPOSiteGroup -Site https://contoso.sharepoint.com/sites/marketing -Group "NewGroupName" -PermissionLevels "Design"

Introduction to the SharePoint Online management shell
Set up the SharePoint Online Management Shell Windows PowerShell environment
New-SPOSite