Get-SPOUnifiedGroupMoveState
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.