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 isfull
. --query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text,csv,md
. Defaultjson
--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¶
- Overview of the "Log in to new Microsoft 365 group" feature: https://docs.microsoft.com/en-us/sharepoint/dev/features/groupify/groupify-overview