Edit

Share via

Start-SPOUserAndContentMove

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell
Applies to:
SharePoint Online

Starts the ability to move a user closer to their sites.

Syntax

PowerShell 
Start-SPOUserAndContentMove
     [-UserPrincipalName] <String>
     [-DestinationDataLocation] <String>
     [[-PreferredMoveBeginDate] <DateTime>]
     [[-PreferredMoveEndDate] <DateTime>]
     [[-Notify] <String>]
     [[-Reserved] <String>]
     [-ValidationOnly]
     [<CommonParameters>]

Description

This cmdlet applies to Multi-Geo tenants and it is designed to move user profiles and their corresponding OneDrive personal sites across geo locations. These cmdlets may only be run by a SharePoint administrator or above, who is connected to the SharePoint administration center of the geo location where the user is currently hosted.

Examples

EXAMPLE 1

PowerShell 
Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation EUR

This example moves the user username@contoso.onmicrosoft.com from their current location, to the European location (EUR).

EXAMPLE 2

PowerShell 
Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation JPN

This example moves the user username@contoso.onmicrosoft.com from their current location, to the Japanese location (JPN).

EXAMPLE 3

PowerShell 
Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation EUR -PreferredMoveBeginDate ((Get-Date).AddHours(1)) -PreferredMoveEndDate ((Get-Date).AddHour(12))

This example moves the user username@contoso.onmicrosoft.com from their current location, to the European location (EUR), with a preferred start move date. Doing so is recommended for administrators who wish to plan their user moves outside business hours and on weekends.

Parameters

-DestinationDataLocation

Defines the destination location where you want to move the user. Note that you may only move a user to their preferred data location. Thus before moving a user, you must change their preferred data location.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Notify

Provides an SPO notification that the user is being moved.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-PreferredMoveBeginDate

Specifies what is the preferred date and time to begin the move.

Type:DateTime
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-PreferredMoveEndDate

Specifies what is the preferred date and time to stop stop the move. Recommened when administrators are scripting large scale moves that they wish to complete within a timeframe.

Type:DateTime
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-UserPrincipalName

UserPrincipalName or UPN defined for the specific user on the SPO tenant

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ValidationOnly

Use this parameter to validate if the user is able to be moved. This parameter is recommended for any user move.

Type:SwitchParameter
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online