Get-PnPRecycleBinItem
SYNOPSIS
Required Permissions
- SharePoint: Site Collection Administrator. SharePoint Tenant Admin alone is not enough
Returns one or more items from the Recycle Bin.
SYNTAX
Identity
Get-PnPRecycleBinItem [-Identity <Guid>] [-Connection <PnPConnection>] [-Includes <String[]>]
FirstStage
Get-PnPRecycleBinItem [-FirstStage] [-RowLimit <Int32>] [-Connection <PnPConnection>] [-Includes <String[]>]
SecondStage
Get-PnPRecycleBinItem [-SecondStage] [-RowLimit <Int32>] [-Connection <PnPConnection>] [-Includes <String[]>]
DESCRIPTION
This command will return all the items in the recycle bin for the SharePoint site you connected to with Connect-PnPOnline. You must connect as a Site Collection Owner or Administrator. The SharePoint Admin Role in the tenant alone will not work. If you are not a Site Collection Admin connect to the Tenant Admin URL with Connect-PnPOnline and use Get-PnPTenantRecycleBinItem.
EXAMPLES
EXAMPLE 1
Get-PnPRecycleBinItem
Returns all items in the first stage recycle bin in the current site collection.
EXAMPLE 2
Get-PnPRecycleBinItem -SecondStage
Returns all items in the second stage recycle bin in the current site collection.
EXAMPLE 3
$AllRBItmes = Get-PnPRecycleBinItem -FirstStage
$AllRBItmes += Get-PnPRecycleBinItem -SecondStage
Populates $AllRBItems with all items in the first and the second stage recycle bins in the current site collection.
EXAMPLE 4
Get-PnPRecycleBinItem -Identity f3ef6195-9400-4121-9d1c-c997fb5b86c2
Returns a specific recycle bin item by id.
EXAMPLE 5
Get-PnPRecycleBinItem -RowLimit 10000
Returns upto 10,000 items from the first stage of the recycle bin in the current site collection.
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: PnPConnection
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FirstStage
Returns all items in the first stage recycle bin.
Note that the -FirstStage parameter is implied if neither the -Identity or the -SecondStage parameters are included.
Type: SwitchParameter
Parameter Sets: FirstStage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identity
Returns a recycle bin item with a specific identity.
Type: Guid
Parameter Sets: Identity
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RowLimit
Limits returned results to specified amount
Type: Int32
Parameter Sets: FirstStage, SecondStage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SecondStage
Returns all items in the second stage recycle bin.
Type: SwitchParameter
Parameter Sets: SecondStage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Includes
Optionally allows properties to be retrieved for the returned recycle bin items which are not included in the response by default
Type: String[]
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False