Edit

Share via

Start-SPOSiteContentMove

Module:
Microsoft.Online.SharePoint.PowerShell Module

Start a job to move a particular user or group of users to be moved across geo locations relative to the one that executes the command

Syntax

UrlAndDestinationDataLocation (Default) 

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

UrlAndDestinationUrl 

Start-SPOSiteContentMove
    [-SourceSiteUrl] <String>
    [-DestinationUrl] <String>
    [[-PreferredMoveBeginDate] <DateTime>]
    [[-PreferredMoveEndDate] <DateTime>]
    [[-Reserved] <String>]
    [-ValidationOnly]
    [-Force]
    [-SuppressMarketplaceAppCheck]
    [-SuppressWorkflow2013Check]
    [-SuppressAllWarnings]
    [-SuppressBcsCheck]
    [<CommonParameters>]

Description

UrlAndDestinationDataLocation: These parameters allow a SharePoint administrator to validate a geo move before scheduling it.

UrlAndDestinationUrl: These parameters allow a SharePoint administrator to move and (optionally) rename a site as part of the geo move operation by specifying a new site name in the destination URL. Renaming a site is not supported for SharePoint Embedded container sites.

Examples

EXAMPLE 1

Start-SPOSiteContentMove -SourceSiteUrl https://contosoenergy.sharepoint.com/sites/hr -DestinationDataLocation EUR

Starts the movement of the content on https://contosoenergy.sharepoint.com/sites/hr to the EUR destination.

EXAMPLE 2

Start-SPOSiteContentMove -SourceSiteUrl https://contosoenergy.sharepoint.com/sites/hr -DestinationDataLocation EUR -PreferredMoveBeginDate ((Get-Date).AddHours(1)) -PreferredMoveEndDate ((Get-Date).AddHour(12))

Starts a site geo move for https://contosoenergy.sharepoint.com/sites/hr to the EUR destination with a preffered start time window of 1 to 12 hours from the move schedule operation.

EXAMPLE 3

Start-SPOSiteContentMove -SourceSiteUrl https://contosoenergy.sharepoint.com/sites/hr -DestinationUrl https://contosoenergyEUR.sharepoint.com/sites/hrEU

Starts a site geo move for https://contosoenergy.sharepoint.com/sites/hr and allows site rename to https://contosoenergyEUR.sharepoint.com/sites/hrEU as part of the geo move operation. Renaming a site is not supported for SharePoint Embedded container sites.

Parameters

-DestinationDataLocation

Applicable: SharePoint Online

Defines the new destination of the content that you want to move. This is the 3 letter data ___location value.

Parameter properties

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

Parameter sets

UrlAndDestinationDataLocation
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DestinationUrl

Applicable: SharePoint Online

Destination URL is optional in cases where the administrator wants to perform a site rename as part of the move.

Parameter properties

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

Parameter sets

UrlAndDestinationUrl
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

{{ Fill Force Description }}

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:6
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PreferredMoveBeginDate

Applicable: SharePoint Online

Specifies what is the preferred Date and time to start the move job. This is a preference and will be honored based on system resource availability.

Parameter properties

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

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PreferredMoveEndDate

Applicable: SharePoint Online

Specifies what is the preferred Date and time to stop the move job from starting. This is a preference and will be honored based on system resource availability. If a the move is already in progress, we will complete the move.

Parameter properties

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

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Reserved

Applicable: SharePoint Online

Reserved for Microsoft Internal use.

Parameter properties

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

Parameter sets

(All)
Position:4
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SourceSiteUrl

Applicable: SharePoint Online

Specifies the source URL of the site collection you want to move.

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

-SuppressAllWarnings

Suppress all warning messages.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:9
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SuppressBcsCheck

Suppress checking for Business Connectivity Services used with the associated site.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:10
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SuppressMarketplaceAppCheck

Suppress checking compatibility of marketplace SharePoint Add-ins deployed to the associated site.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:7
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SuppressWorkflow2013Check

Suppress checking compatibility of SharePoint 2013 Workflows deployed to the associated site.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:8
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ValidationOnly

Applicable: SharePoint Online

This parameter will perform a validation check on whether the site can be moved and will not execute the move.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:5
Mandatory:False
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