Skip to content

spo site groupify

Connects site collection to an Microsoft 365 Group

Attention

This command is based on a SharePoint API that is currently in preview and is subject to change once the API reached general availability.

Usage

m365 spo site groupify [options]

Options

-u, --url <url>
URL of the site collection being connected to new Microsoft 365 Group
-a, --alias <alias>
The email alias for the new Microsoft 365 Group that will be created
-n, --displayName <displayName>
The name of the new Microsoft 365 Group that will be created
-d, --description [description]
The group’s description
-c, --classification [classification]
The classification value, if classifications are set for the organization. If no value is provided, the default classification will be set, if one is configured
--isPublic
Determines the Microsoft 365 Group’s privacy setting. If set, the group will be public, otherwise it will be private
--keepOldHomepage
For sites that already have a modern page set as homepage, set this option, to keep it as the homepage
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

When connecting site collection to an Microsoft 365 Group, SharePoint will create a new group using the specified information. If a group with the same name already exists, you will get a The group alias already exists. error.

Examples

Connect site collection to an Microsoft 365 Group

m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A'

Connect site collection to an Microsoft 365 Group and make the group public

m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --isPublic

Connect site collection to an Microsoft 365 Group and set the group classification

m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --classification HBI

Connect site collection to an Microsoft 365 Group and keep the old home page

m365 spo site groupify --url https://contoso.sharepoin.com/sites/team-a --alias team-a --displayName 'Team A' --keepOldHomepage

More information