New-PnPList

Creates a new list

Syntax

New-PnPList
   -Title <String>
              -Template <ListTemplateType>
              [-Url <String>]
              [-Hidden [<SwitchParameter>]]
              [-EnableVersioning [<SwitchParameter>]]
              [-EnableContentTypes [<SwitchParameter>]]
              [-OnQuickLaunch [<SwitchParameter>]]
              [-Web <WebPipeBind>]
              [-Connection <SPOnlineConnection>]

Examples

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

New-PnPList -Title Announcements -Template Announcements

Create a new announcements list

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

New-PnPList -Title "Demo List" -Url "DemoList" -Template Announcements

Create a list with a title that is different from the url

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

New-PnPList -Title HiddenList -Template GenericList -Hidden

Create a new custom list and hides it from the SharePoint UI.

Required Parameters

-Template

The type of list to create.

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

The Title of the list

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

Optional Parameters

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

Switch parameter if content types should be enabled on this list

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

Switch parameter if versioning should be enabled

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

Switch parameter if list should be hidden from the SharePoint UI

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

Switch parameter if this list should be visible on the QuickLaunch

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

If set, will override the url of the list.

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