Add-PnPMicrosoft365GroupToSite
SYNOPSIS
Required Permissions
- SharePoint: Access to the SharePoint Tenant Administration site + SharePoint site collection admin
- SharePoint permissions:
Sites.FullControl.All(application) orAllSites.FullControl(delegated) - Ensure the user/account is allowed to create Microsoft 365 Groups (tenant policy), has access to SharePoint admin site and is site collection admin of the site to be groupified.
Groupifies a classic team site by creating a Microsoft 365 group for it and connecting the site with the newly created group.
SYNTAX
Add-PnPMicrosoft365GroupToSite -Url <String> -Alias <String> -DisplayName <String> [-Description <String>]
[-Classification <String>] [-IsPublic] [-KeepOldHomePage] [-HubSiteId <Guid>] [-Owners <String[]>]
[-Connection <PnPConnection>]
DESCRIPTION
This command allows you to add a Microsoft 365 Unified group to an existing classic site collection, also known as groupifying.
EXAMPLES
EXAMPLE 1
Add-PnPMicrosoft365GroupToSite -Url "https://contoso.sharepoint.com/sites/FinanceTeamsite" -Alias "FinanceTeamsite" -DisplayName "My finance team site group"
This will groupify the FinanceTeamsite at the provided URL.
EXAMPLE 2
Add-PnPMicrosoft365GroupToSite -Alias "HRTeamsite" -DisplayName "My HR team site group"
This will groupify the currently connected site.
EXAMPLE 3
Add-PnPMicrosoft365GroupToSite -Url $SiteURL -Alias $GroupAlias -DisplayName $GroupName -IsPublic -KeepOldHomePage
This will groupify the $SiteURL site, make the Group public (default is Private) and keep the old Home page as the default homepage. The new Home.aspx is created but not set as default Homepage.
PARAMETERS
-Alias
Specifies the alias of the group. Cannot contain spaces.
Type: String
Parameter Sets: (All)
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Classification
Specifies the classification of the group.
Type: String
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
The optional description of the group.
Type: String
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisplayName
The display name of the group.
Type: String
Parameter Sets: (All)
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HubSiteId
If specified the site will be associated to the hubsite as identified by this id.
Type: Guid
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsPublic
Specifies if the group is public. Defaults to false.
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeepOldHomePage
Specifies if the current site home page is kept. Defaults to false.
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Owners
The array of the UPN values of the group's owners.
Type: String[]
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Url
Url of the site to be connected to an Microsoft 365 Group. When not provided, the site currently being connected to will be used.
Type: String
Parameter Sets: (All)
Required: False
Position: Named
Default value: Currently connected site
Accept pipeline input: False
Accept wildcard characters: False