Table of Contents

Get-PnPTenantDeletedSite

SYNOPSIS

Required Permissions

  • SharePoint: Access to the SharePoint Tenant Administration site

Fetches the site collections from the tenant recycle bin.

SYNTAX

Get-PnPTenantDeletedSite [-Identity] <String> [-Limit] [-IncludePersonalSite] [-IncludeOnlyPersonalSite] [-Detailed] [-Verbose] [-Connection <PnPConnection>] 

DESCRIPTION

Fetches the site collections which are listed in your tenant's recycle bin.

EXAMPLES

EXAMPLE 1

Get-PnPTenantDeletedSite

This will fetch basic information on site collections located in the recycle bin.

EXAMPLE 2

Get-PnPTenantDeletedSite -Detailed

This will fetch detailed information on site collections located in the recycle bin.

EXAMPLE 3

Get-PnPTenantDeletedSite -Identity "https://tenant.sharepoint.com/sites/contoso"

This will fetch basic information on the site collection with the url 'https://tenant.sharepoint.com/sites/contoso' from the recycle bin.

EXAMPLE 4

Get-PnPTenantDeletedSite -IncludePersonalSite

This will fetch the site collections from the recycle bin including the personal sites and display its properties.

EXAMPLE 5

Get-PnPTenantDeletedSite -IncludeOnlyPersonalSite

This will fetch the site collections from the recycle bin which are personal sites and display its properties.

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

-Detailed

When specified, detailed information will be returned on the site collections. This will take longer to execute.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

Specifies the full URL of the site collection that needs to be restored.

Type: String
Parameter Sets: (All)

Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-IncludeOnlyPersonalSite

If specified the task will only retrieve the personal sites from the recycle bin.

Type: SwitchParameter
Parameter Sets: (ParameterSetPersonalSitesOnly)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludePersonalSite

If specified the task will also retrieve the personal sites from the recycle bin.

Type: SwitchParameter
Parameter Sets: (ParameterSetAllSites)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Limit

Limit of the number of site collections to be retrieved from the recycle bin. Default is 200.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Microsoft 365 Patterns and Practices