Remove-PnPList

Deletes a list

Syntax

Remove-PnPList
      -Identity <ListPipeBind>
                    [-Recycle [<SwitchParameter>]]
                    [-Force [<SwitchParameter>]]
                    [-Web <WebPipeBind>]
                    [-Connection <SPOnlineConnection>]

Examples

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

Remove-PnPList -Identity Announcements

Removes the list named 'Announcements'. Asks for confirmation.

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

Remove-PnPList -Identity Announcements -Force

Removes the list named 'Announcements' without asking for confirmation.

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

Remove-PnPList -Title Announcements -Recycle

Removes the list named 'Announcements' and saves to the Recycle Bin

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

Specifying the Force parameter will skip the confirmation question.

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

The ID or Title of the list.

Type:ListPipeBind
Position:0
Accept pipeline input:True
Accept wildcard characters:False
-Recycle

Defines if the list should be moved to recycle bin or directly deleted.

Type:SwitchParameter
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