Start-SPOSiteRename

> [!NOTE] > This Feature is part of the Admin Center Preview. If your tenant is not part of the Admin Center Preview, you will get an error when trying to run this cmdlet.

Starts a job to rename a site. You can change the title, the URL or both of a particular site on a SharePoint Online collection

Syntax

Start-SPOSiteRename
     [-Identity] <SpoSitePipeBind>
     [-NewSiteUrl] <string>
     [[-NewSiteTitle] <string>]
        [[-SuppressMarketplaceAppCheck]]
     [[-SuppressWorkflow2013Check]]
     [[-Reserved] <string>]
     [-WhatIf]
     [-Confirm]   
     [<CommonParameters>]

Description

This command starts a rename of a site on a SharePoint Online site into a new title, name and url. Also allows you to simulate the run using the -WhatIf parameter as well as -SuppressWorkflow2013Check and SuppressMarketplaceAppCheck switch parameters.

Examples

EXAMPLE 1

$url="https://<tenant>.sharepoint.com/site/samplesite"
$NewSiteUrl="https://<tenant>.sharepoint.com/site/renamed"
Start-SPOSiteRename -Identity $url -NewSiteUrl $NewSiteUrl

Starts the rename of the SPO site with name "samplesite" to "renamed" without modifying the title.

EXAMPLE 2

$url="https://<tenant>.sharepoint.com/site/samplesite"
$NewSiteUrl="https://<tenant>.sharepoint.com/site/renamed"
$newTitle="New Title"
Start-SPOSiteRename-Identity $url  -NewSiteUrl $NewSiteUrl -NewSiteTitle $newTitle

Starts the rename of the SPO site with name "samplesite" to "renamed" modifying the title of the site to "New Title"

EXAMPLE 3

$url="https://<tenant>.sharepoint.com/site/samplesite"
$NewSiteUrl="https://<tenant>.sharepoint.com/site/renamed" 
$newTitle="New Title"
Start-SPOSiteRename -Identity $url -NewSiteUrl $NewSiteUrl -NewSiteTitle $newTitle -SuppressMarketplaceAppCheck -SuppressWorkflow2013Check -WhatIf

Starts the simulation rename of the SPO site with name "samplesite" to "renamed" modifying the title of the site to "New Title" without MarketPlaceAppCheck and without WorkFlow2013Check

Parameters

-Confirm

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-Identity

PARAMVALUE: String

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-NewSiteTitle

PARAMVALUE: String

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-NewSiteUrl

PARAMVALUE: String

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-Reserved

PARAMVALUE: String

Type:String
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-SuppressMarketplaceAppCheck

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Position:4
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-SuppressWorkflow2013Check

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Position:5
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online
-WhatIf

Simulation of what would happend if you run the script without modifying anything.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online