Commands › SharePoint Online

Start-SPOUnifiedGroupMove

SharePoint Online Microsoft.Online.SharePoint.PowerShell Start-*

Initiates the move of an Office 365 Group to a new geo location

Quick start script

# Start-SPOUnifiedGroupMove — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com

# 2. Run and inspect
Start-SPOUnifiedGroupMove -DestinationDataLocation <String> -GroupAlias <String> | Format-List

# 3. Export for evidence / drift tracking
Start-SPOUnifiedGroupMove | Export-Clixml .\SPOUnifiedGroupMove-$(Get-Date -Format yyyyMMdd).xml

Syntax

Start-SPOUnifiedGroupMove [-GroupAlias] <String> [-DestinationDataLocation] <String>
 [[-PreferredMoveBeginDate] <DateTime>] [[-PreferredMoveEndDate] <DateTime>] [[-Reserved] <String>]
 [-ValidationOnly] [-Force] [-SuppressMarketplaceAppCheck] [-SuppressWorkflow2013Check] [-SuppressAllWarnings]
 [-SuppressBcsCheck] [<CommonParameters>]

Parameters (11)

ParameterTypeRequiredWhat it controls
-DestinationDataLocation String yes The destination location for the Office 365 Group site move.
-Force SwitchParameter Force the cmdlet to run. This ignores all warning blocks and validations. It is only recommended if the administrator only wishes to preserve data and is not interested in checks for applications, Business...
-GroupAlias String yes The alias of the Office 365 Group attached to the site you want to move.
-PreferredMoveBeginDate DateTime The move will likely begin at this specified time.
-PreferredMoveEndDate DateTime The move will likely be completed by this specified time, on a best effort basis.
-Reserved String This parameter is reserved for internal Microsoft use.
-SuppressAllWarnings SwitchParameter Suppress all warning messages.
-SuppressBcsCheck SwitchParameter Suppress checking for Business Connectivity Services used with the associated Office 365 Group site.
-SuppressMarketplaceAppCheck SwitchParameter Suppress checking compatibility of marketplace SharePoint Add-ins deployed to the associated Office 365 Group site.
-SuppressWorkflow2013Check SwitchParameter Suppress checking compatibility of SharePoint 2013 Workflows deployed to the associated Office 365 Group site.
-ValidationOnly SwitchParameter This parameter will force the cmdlet to execute only validation.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.