spo site remove
Removes the specified site
Usage
m365 spo site remove [options]
Options
-u, --url <url>
URL of the site to remove
--skipRecycleBin
Set to directly remove the site without moving it to the Recycle Bin
--fromRecycleBin
Set to remove the site from the Recycle Bin
--wait
Wait for the site to be removed before completing the command
-f, --force
Don't prompt for confirming removing the site
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are
options
,examples
,remarks
,response
,full
. Default isoptions
.--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples.
-o, --output [output]
Output type.
json
,text
,csv
,md
,none
. Defaultjson
.--verbose
Runs command with verbose logging.
--debug
Runs command with debug logging.
Remarks
Deleting a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully deleted, you should use the --wait
flag. When using this flag, the spo site remove
command will keep running until it received confirmation from Microsoft 365 that the site has been fully deleted.
If the site which you have selected to remove is groupified (Modern Team Site) and group exists, flags --skipRecycleBin
and --wait
will not be applicable. If the linked group still exists in the deleted groups, the site won't be removed. If the linked group is permanently deleted, the site will be removed like any classic site (except that flag --wait
only will still not be applicable).
If the argument --fromRecycleBin
is passed, the selected site will be permanently removed even if it's a groupified one.
To use this command you have to have permissions to access the tenant admin site.
Examples
Remove the specified site and place it in the Recycle Bin
m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite
Remove the site without moving it to the Recycle Bin
m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --skipRecycleBin
Remove the previously deleted site from the Recycle Bin
m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --fromRecycleBin
Remove the site without moving it to the Recycle Bin and wait for completion
m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --wait --skipRecycleBin
Response
The command won't return a response on success.