Share via


Get-SPOUnifiedGroupMoveState

Returns the state of an Office 365 Group move between Preferred Data Locations.

Syntax

Default (Default)

Get-SPOUnifiedGroupMoveState
    [-GroupAlias] <String>
    [<CommonParameters>]

Description

Retrieves the state of the Office 365 Group move to the Preferred Data Location (PDL) for the specified. The customer tenant must be multi-geo enabled.

Examples

Example 1

Get-SPOUnifiedGroupMoveState -GroupAlias EUTeam

Returns the status of the move between geos for the Office 365 Group named 'EUTeam'.

Parameters

-GroupAlias

Applicable: SharePoint Online

The alias of the Office 365 Group.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
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.

Inputs

None

Outputs

System.Object

The move status for the Office 365 Group. Possible values are:

  • Ready to Trigger: The move has not started.
  • Scheduled: The move is in queue but has not yet started.
  • InProgress (n/4): The move is in progress in one of the following states: Validation (1/4), Backup (2/4), Restore (3/4), Cleanup (4/4).
  • 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.

Notes

You can also apply the -Verbose option to see additional information about the move.