| external help file | sharepointonline.xml |
|---|---|
| Module Name | Microsoft.Online.SharePoint.PowerShell |
| online version | https://learn.microsoft.com/powershell/module/sharepoint-online/get-spouserandcontentmovestate |
| applicable | SharePoint Online |
| title | Get-SPOUserAndContentMoveState |
| schema | 2.0.0 |
| author | trent-green |
| ms.author | trgreen |
| ms.reviewer |
This cmdlet allows SharePoint administrators to check the status of a user or site move across geo locations.
Get-SPOUserAndContentMoveState [-Limit <UInt32>] [-MoveDirection <Direction>] [-MoveEndTime <DateTime>]
[-MoveStartTime <DateTime>] [-MoveState <State>] [<CommonParameters>]Get-SPOUserAndContentMoveState -OdbMoveId <Guid> [<CommonParameters>]Get-SPOUserAndContentMoveState -UserPrincipalName <String> [<CommonParameters>]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. |
Get-SPOUserAndContentMoveState -OdbMoveId b298219e-3440-10b8-8931-46e805e2b85bObtain the move state by OneDrive Move Job ID
Get-SPOUserAndContentMoveState -MoveState NotStartedGetting which moves are being done in a particular state
Get-SPOUserAndContentMoveState -MoveDirection AllGives you the output for users moving in and out from the geo location you are logged into
Get-SPOUserAndContentMoveState -MoveDirection InGives you the output for users moving into the geo location that you are logged into
Get-SPOUserAndContentMoveState -MoveDirection OutGives you the output for users moving out from the geo location that you are logged into
Get-SPOUserAndContentMoveState -UserPrincipalName jezz@contoso.comObtains the status of the move for jezz@contoso.com
Get the limit of user on a single call of the parameter
Type: UInt32
Parameter Sets: MoveReport
Aliases:
Applicable: SharePoint Online
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAllows you to define the direction of the user move in relation to your current SharePoint location
Type: Direction
Parameter Sets: MoveReport
Aliases:
Accepted values: All, MoveIn, MoveOut
Applicable: SharePoint Online
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAllows you to obtain the moves that are scheduled to end by a particular time, as defined in UTC
Type: DateTime
Parameter Sets: MoveReport
Aliases:
Applicable: SharePoint Online
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAllows you to obtain the moves that are scheduled to begin at a particular time, as defined in UTC
Type: DateTime
Parameter Sets: MoveReport
Aliases:
Applicable: SharePoint Online
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseMove State current status.
Type: State
Parameter Sets: MoveReport
Aliases:
Accepted values: All, NotStarted, Scheduled, InProgress, Stopped, Success, Failed
Applicable: SharePoint Online
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseOneDrive GUID MoveID that you get when you start a job.
Type: Guid
Parameter Sets: OdbMoveId
Aliases:
Applicable: SharePoint Online
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseUser Principal name is the unique property on Microsoft Entra ID for each user.
Type: String
Parameter Sets: UserPrincipalName
Aliases:
Applicable: SharePoint Online
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.