Edit

Share via

Remove-SPOSite

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell
Applies to:
SharePoint Online

Sends a SharePoint Online site collection to the SharePoint Online Recycle Bin.

Syntax

Remove-SPOSite
      [-Confirm]
      -Identity <SpoSitePipeBind>
      [-NoWait]
      [-WhatIf]
      [<CommonParameters>]

Description

The Remove-SPOSite cmdlet does not delete a site collection from the site collections list permanently. Instead, the removed site collection is moved to the Recycle Bin. You can use the Restore-SPODeletedSitecmdlet to restore a site collection from the Recycle Bin. To delete a site collection permanently, first move the site collection to the Recycle Bin by using the Remove-SPOSite cmdlet and then delete it from the Recycle Bin by using the Remove-SPODeletedSite cmdlet.

You must be at least a SharePoint Online administrator and be a site collection administrator to run the cmdlet.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

Examples

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

Remove-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -NoWait

This example immediately removes the site collection named https://contoso.sharepoint.com/sites/site1 from the site collections list and moves it to the Recycle Bin.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

Specifies the URL of the site collection to remove.

Type:SpoSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-NoWait

Specifies to continue executing script immediately.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online