New-PnPUnifiedGroup

Creates a new Office 365 Group (aka Unified Group)

Syntax

New-PnPUnifiedGroup
   -DisplayName <String>
                      -Description <String>
                      -MailNickname <String>
                      [-Owners <String[]>]
                      [-Members <String[]>]
                      [-IsPrivate [<SwitchParameter>]]
                      [-GroupLogoPath <String>]
                      [-CreateTeam [<SwitchParameter>]]
                      [-Force [<SwitchParameter>]]

Examples

------------------EXAMPLE 1------------------

New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname

Creates a public Office 365 Group with all the required properties

------------------EXAMPLE 2------------------

New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname -Owners $arrayOfOwners -Members $arrayOfMembers

Creates a public Office 365 Group with all the required properties, and with a custom list of Owners and a custom list of Members

------------------EXAMPLE 3------------------

New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname -IsPrivate

Creates a private Office 365 Group with all the required properties

------------------EXAMPLE 4------------------

New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname -Owners $arrayOfOwners -Members $arrayOfMembers -IsPrivate

Creates a private Office 365 Group with all the required properties, and with a custom list of Owners and a custom list of Members

Parameters

-CreateTeam

Creates a MS Teams team associated with created group.

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Description

The Description of the Office 365 Group.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-DisplayName

The Display Name of the Office 365 Group.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Force

Specifying the Force parameter will skip the confirmation question.

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-GroupLogoPath

The path to the logo file of to set.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-IsPrivate

Makes the group private when selected.

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-MailNickname

The Mail Nickname of the Office 365 Group. Cannot contain spaces.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Members

The array UPN values of the group's members.

Type:String[]
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Owners

The array UPN values of the group's owners.

Type:String[]
Position:Named
Accept pipeline input:False
Accept wildcard characters:False