Clear-PnPRecycleBinItem
SYNOPSIS
Permanently deletes all or a specific recycle bin item
SYNTAX
All (Default)
Clear-PnPRecycleBinItem [-All] [-SecondStageOnly] [-Force] [-RowLimit <Int32>] [-Connection <PnPConnection>]
Identity
Clear-PnPRecycleBinItem -Identity <RecycleBinItemPipeBind> [-Force] [-Connection <PnPConnection>]
DESCRIPTION
Allows to permanently delete items from recycle bin. By default the command will delete all items but it is allowed to specify the items by using the Identity or RowLimit options.
EXAMPLES
EXAMPLE 1
Get-PnPRecycleBinItem | Where-Object LeafName -like "*.docx" | Clear-PnPRecycleBinItem
Permanently deletes all the items in the first and second stage recycle bins of which the file names have the .docx extension
EXAMPLE 2
Clear-PnPRecycleBinItem -Identity 72e4d749-d750-4989-b727-523d6726e442
Permanently deletes the recycle bin item with Id 72e4d749-d750-4989-b727-523d6726e442 from the recycle bin
EXAMPLE 3
Clear-PnPRecycleBinItem -Identity $item -Force
Permanently deletes the recycle bin item stored under variable $item from the recycle bin without asking for confirmation from the end user first
EXAMPLE 4
Clear-PnPRecycleBinItem -All -RowLimit 10000
Permanently deletes up to 10,000 items in the recycle bin
PARAMETERS
-All
Clears all items
Type: SwitchParameter
Parameter Sets: All
Required: False
Position: Named
Default value: None
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: PnPConnection
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
If provided, no confirmation will be asked to clear the recycle bin
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identity
Id of the recycle bin item or the recycle bin item itself to permanently delete
Type: RecycleBinItemPipeBind
Parameter Sets: Identity
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-RowLimit
Limits deletion to specified number of items
Type: Int32
Parameter Sets: All
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SecondStageOnly
If provided, only all the items in the second stage recycle bin will be cleared
Type: SwitchParameter
Parameter Sets: All
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False