Commands › SharePoint Online

Get-SPOUserAndContentMoveState

SharePoint Online Microsoft.Online.SharePoint.PowerShell Get-*

This cmdlet allows SharePoint administrators to check the status of a user or site move across geo locations.

Quick start script

# Get-SPOUserAndContentMoveState — 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
Get-SPOUserAndContentMoveState -OdbMoveId <Guid> -UserPrincipalName <String> | Format-List

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

Syntax — 3 parameter sets

MoveReport (Default)

Get-SPOUserAndContentMoveState [-Limit <UInt32>] [-MoveStartTime <DateTime>] [-MoveEndTime <DateTime>]
 [-MoveState <MoveState>] [-MoveDirection <MoveDirection>] [<CommonParameters>]

UserPrincipalName

Get-SPOUserAndContentMoveState -UserPrincipalName <String> [<CommonParameters>]

OdbMoveId

Get-SPOUserAndContentMoveState -OdbMoveId <Guid> [<CommonParameters>]

Parameters (7)

Parameter	Type	Required	What it controls
-Limit	UInt32		Get the limit of user on a single call of the parameter
-MoveDirection	MoveDirection		Allows you to define the direction of the user move in relation to your current SharePoint location
-MoveEndTime	DateTime		Allows you to obtain the moves that are scheduled to end by a particular time, as defined in UTC
-MoveStartTime	DateTime		Allows you to obtain the moves that are scheduled to begin at a particular time, as defined in UTC
-MoveState	MoveState		Move State current status.
-OdbMoveId	Guid	yes	OneDrive GUID MoveID that you get when you start a job.
-UserPrincipalName	String	yes	User Principal name is the unique property on Microsoft Entra ID for each user.

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