Skip to content

Latest commit

 

History

History
305 lines (214 loc) · 7.59 KB

File metadata and controls

305 lines (214 loc) · 7.59 KB
external help file Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
Module Name Microsoft.Online.SharePoint.PowerShell
online version https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/start-spositecontentmove
applicable SharePoint Online
title Start-SPOSiteContentMove
schema 2.0.0
author samkabue
ms.author speedta
ms.reviewer

Start-SPOSiteContentMove

SYNOPSIS

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.

Type: System.String
Parameter Sets: UrlAndDestinationDataLocation
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: System.String
Parameter Sets: UrlAndDestinationUrl
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Applicable: SharePoint Online

Whether to start the move process without prompting for confirmation.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: System.DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: System.DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Reserved

Applicable: SharePoint Online

Reserved for Microsoft Internal use.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SourceSiteUrl

Applicable: SharePoint Online

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

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressAllWarnings

Suppress all warning messages.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 9
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressBcsCheck

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

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 10
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressMarketplaceAppCheck

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

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 7
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressWorkflow2013Check

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

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 8
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Getting started with SharePoint Online Management Shell

Get-SPOAppErrors

Start-SPOSiteRename

Stop-SPOUserAndContentMove

Get-SPOUserAndContentMoveState