Edit

Share via

Get-SPOUnifiedGroupMoveState

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell
Applies to:
SharePoint Online

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

Syntax

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

-Confirm

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-GroupAlias

The alias of the Office 365 Group.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

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.

Note

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