Commands › SharePoint Online

Start-SPOUserAndContentMove

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

Starts the ability to move a user closer to their sites.

Quick start script

# Start-SPOUserAndContentMove — 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-SPOUserAndContentMove -DestinationDataLocation <String> -UserPrincipalName <String> | Format-List

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

Syntax

Start-SPOUserAndContentMove [-UserPrincipalName] <String> [-DestinationDataLocation] <String>
 [[-PreferredMoveBeginDate] <DateTime>] [[-PreferredMoveEndDate] <DateTime>] [[-Notify] <String>]
 [[-Reserved] <String>] [-ValidationOnly] [<CommonParameters>]

Parameters (7)

Parameter	Type	Required	What it controls
-DestinationDataLocation	String	yes	Defines the destination location where you want to move the user. Note that you may only move a user to their preferred data location. Thus before moving a user, you must change their preferred data location.
-Notify	String		Provides an SPO notification that the user is being moved.
-PreferredMoveBeginDate	DateTime		Specifies what is the preferred date and time to begin the move.
-PreferredMoveEndDate	DateTime		Specifies what is the preferred date and time to stop stop the move. Recommened when administrators are scripting large scale moves that they wish to complete within a timeframe.
-Reserved	String		Reserved.
-UserPrincipalName	String	yes	UserPrincipalName or UPN defined for the specific user on the SPO tenant
-ValidationOnly	SwitchParameter		Use this parameter to validate if the user is able to be moved. This parameter is recommended for any user move.

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