Start-SPOUserAndContentMove
Starts the ability to move a user closer to their sites.
Syntax
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
Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation EURThis example moves the user username@contoso.onmicrosoft.com from their current location, to the European location (EUR).
EXAMPLE 2
Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation JPNThis example moves the user username@contoso.onmicrosoft.com from their current location, to the Japanese location (JPN).
EXAMPLE 3
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 |