Get-SPOUserAndContentMoveState
This cmdlet allows SharePoint administrators to check the status of a user or site move across geo locations.
Syntax
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>]
Description
This command gets the information and the status of a move request of a user between sites in a SharePoint Online Multi Geo tenant.
The following are the available move states:
| Status | Description |
|---|---|
| ReadyToTrigger | The move is ready to be initiated by an administrator. |
| NotStarted | The move has not started. |
| InProgress | The move is in progress in one of the following states: Validation, Backup, Restore, Cleanup. |
| Success | The move has completed successfully. |
| Failed | The move failed. |
| Stopped | The move was canceled by an administrator while it was still queued. |
| NotSupported | The move could not be processed because the Preferred Data Location was invalid. |
| Rescheduled | The move did not succeed and is being scheduled again for another attempt. |
Examples
Example 1
Get-SPOUserAndContentMoveState -OdbMoveId b298219e-3440-10b8-8931-46e805e2b85b
Obtain the move state by OneDrive Move Job ID
Example 2
Get-SPOUserAndContentMoveState -MoveState NotStarted
Getting which moves are being done in a particular state
Example 3
Get-SPOUserAndContentMoveState -MoveDirection All
Gives you the output for users moving in and out from the geo location you are logged into
Example 4
Get-SPOUserAndContentMoveState -MoveDirection In
Gives you the output for users moving into the geo location that you are logged into
Example 5
Get-SPOUserAndContentMoveState -MoveDirection Out
Gives you the output for users moving out from the geo location that you are logged into
Example 6
Get-SPOUserAndContentMoveState -UserPrincipalName jezz@contoso.com
Obtains the status of the move for jezz@contoso.com
Parameters
-Limit
Applicable: SharePoint Online
Get the limit of user on a single call of the parameter
Parameter properties
| Type: | System.UInt32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
MoveReport
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MoveDirection
Allows you to define the direction of the user move in relation to your current SharePoint location
Parameter properties
| Type: | Microsoft.Online.SharePoint.PowerShell.MoveDirection |
| Default value: | None |
| Accepted values: | MoveOut, MoveIn, All |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
MoveReport
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MoveEndTime
Applicable: SharePoint Online
Allows you to obtain the moves that are scheduled to end by a particular time, as defined in UTC
Parameter properties
| Type: | System.DateTime |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
MoveReport
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MoveStartTime
Applicable: SharePoint Online
Allows you to obtain the moves that are scheduled to begin at a particular time, as defined in UTC
Parameter properties
| Type: | System.DateTime |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
MoveReport
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MoveState
Applicable: SharePoint Online
Move State current status.
Parameter properties
| Type: | Microsoft.Online.SharePoint.PowerShell.MoveState |
| Default value: | None |
| Accepted values: | NotStarted, InProgress, Success, Failed, Stopped, Queued, NotSupported, Rescheduled, All |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
MoveReport
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-OdbMoveId
Applicable: SharePoint Online
OneDrive GUID MoveID that you get when you start a job.
Parameter properties
| Type: | System.Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
OdbMoveId
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-UserPrincipalName
Applicable: SharePoint Online
User Principal name is the unique property on Microsoft Entra ID for each user.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UserPrincipalName
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.