New-PnPGroup

Adds group to the Site Groups List and returns a group object

Syntax

New-PnPGroup
   -Title <String>
               [-Description <String>]
               [-Owner <String>]
               [-AllowRequestToJoinLeave [<SwitchParameter>]]
               [-AutoAcceptRequestToJoinLeave [<SwitchParameter>]]
               [-AllowMembersEditMembership [<SwitchParameter>]]
               [-DisallowMembersViewMembership [<SwitchParameter>]]
               [-RequestToJoinEmail <String>]
               [-Web <WebPipeBind>]
               [-Connection <SPOnlineConnection>]

Examples

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

New-PnPGroup -Title "My Site Users"

Parameters

-AllowMembersEditMembership

A switch parameter that specifies whether group members can modify membership in the group

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

A switch parameter that specifies whether to allow users to request membership in the group and to allow users to request to leave the group

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

A switch parameter that specifies whether users are automatically added or removed when they make a request

Type:SwitchParameter
Position:Named
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:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Description

The description for the group

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

A switch parameter that disallows group members to view membership.

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

The owner for the group, which can be a user or another group

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

The e-mail address to which membership requests are sent

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

The Title of the group

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

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.SharePoint.Client.Group