New-PnPUnifiedGroup.md

external help file	applicable	schema
	SharePoint Online	2.0.0

New-PnPUnifiedGroup

SYNOPSIS

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>]]

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

PARAMETERS

-Description

The Description of the Office 365 Group.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-DisplayName

The Display Name of the Office 365 Group.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Force

Specifying the Force parameter will skip the confirmation question.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-GroupLogoPath

The path to the logo file of to set.

Type: String
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-IsPrivate

Makes the group private when selected.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-MailNickname

The Mail Nickname of the Office 365 Group.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Members

The array UPN values of the group's members.

Type: String[]
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Owners

The array UPN values of the group's owners.

Type: String[]
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

RELATED LINKS

SharePoint Developer Patterns and Practices