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.