Skip to main content

spo site groupify

Connects site collection to an Microsoft 365 Group

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

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

caution

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

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

Response​

{
  "DocumentsUrl": null,
  "ErrorMessage": null,
  "GroupId": "a82ece01-09bd-4585-8247-7a0b72c97377",
  "SiteStatus": 2,
  "SiteUrl": "https://contoso.sharepoint.com/sites/team-a"
}

More information​

CTRL + M