Commands › SharePoint Online

Start-SPOTenantRename

SharePoint Online Microsoft.Online.SharePoint.PowerShell Start-*

> [!IMPORTANT] > This feature is currently available to organizations that have no more than 10,000 total SharePoint sites and OneDrive accounts combined. Additionally, tenant renaming capability is not available for GCC, GCC High, and DoD. Starts a job to change the SharePoint domain name for your organization in Microsoft 365. For example, if the name of your organization changes from "Contoso" to "Fabrikam," you can change contoso.sharepoint.com to fabrikam.sharepoint.com. > [!WARNING] > Changing your SharePoint domain name might take several hours to days depending on the number of sites a

Quick start script

# Start-SPOTenantRename — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com

# 2. Run and inspect
Start-SPOTenantRename -DomainName <String> -ScheduledDateTime <DateTime> | Format-List

# 3. Export for evidence / drift tracking
Start-SPOTenantRename | Export-Clixml .\SPOTenantRename-$(Get-Date -Format yyyyMMdd).xml

Syntax

Start-SPOTenantRename -DomainName <String> -ScheduledDateTime <DateTime> [-WhatIf] [-Confirm]
 [<CommonParameters>]

Parameters (4)

Parameter	Type	Required	What it controls
-DomainName	String	yes	Specifies the domain name that the current SharePoint domain name will be renamed to. This is the part before "sharepoint.com" or "onmicrosoft.com".
-ScheduledDateTime	DateTime	yes	Specifies the date-time that the job will be started. This should be at least 24 hours in the future, but no more than 30 days.
-Confirm	SwitchParameter
-WhatIf	SwitchParameter		### CommonParameters

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.