Table of contents
TOC
Collapse the table of content
Expand the table of content

New-PnPUnifiedGroup

Bert Jansen|Last Updated: 2/20/2017
|
1 Contributor

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>]
                    [-Force [<SwitchParameter>]]

Parameters

ParameterTypeRequiredDescription
DescriptionStringTrueThe Description of the Office 365 Group.
DisplayNameStringTrueThe Display Name of the Office 365 Group.
MailNicknameStringTrueThe Mail Nickname of the Office 365 Group.
ForceSwitchParameterFalseSpecifying the Force parameter will skip the confirmation question.
GroupLogoPathStringFalseThe path to the logo file of to set.
IsPrivateSwitchParameterFalseMakes the group private when selected.
MembersString[]FalseThe array UPN values of the group's members.
OwnersString[]FalseThe array UPN values of the group's owners.

Examples

Example 1

PS:> New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname

Creates a public Office 365 Group with all the required properties

Example 2

PS:> 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

PS:> New-PnPUnifiedGroup -DisplayName $displayName -Description $description -MailNickname $nickname -IsPrivate

Creates a private Office 365 Group with all the required properties

Example 4

PS:> 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

© 2017 Microsoft