Commands › SharePoint Online

New-SPOSiteGroup

SharePoint Online Microsoft.Online.SharePoint.PowerShell New-*

Creates a new group in a SharePoint Online site collection.

Quick start script

# New-SPOSiteGroup — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-SPOSiteGroup
$before | Format-List

# 3. Make the change
New-SPOSiteGroup -Group <String> -PermissionLevels <String[]> -Site <SpoSitePipeBind>

# 4. Verify and diff
$after = Get-SPOSiteGroup
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

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

Parameters (3)

Parameter	Type	Required	What it controls
-Group	String	yes	Specifies the name of the group to add.
-PermissionLevels	String[]	yes	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.
-Site	SpoSitePipeBind	yes	Specifies the site collection to add the group to.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.