Start-SPOUserAndContentMove
Starts the ability to move a user closer to their sites.
Syntax
Default (Default)
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 EUR
This 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 JPN
This 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
Applicable: SharePoint Online
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.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Notify
Applicable: SharePoint Online
Provides an SPO notification that the user is being moved.
Parameter properties
| Type: | System.String |
| 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 |
-PreferredMoveBeginDate
Applicable: SharePoint Online
Specifies what is the preferred date and time to begin 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 |
-PreferredMoveEndDate
Applicable: SharePoint Online
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.
Parameter properties
| Type: | System.DateTime |
| 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 |
-Reserved
Applicable: SharePoint Online
Reserved.
Parameter properties
| Type: | System.String |
| 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 |
-UserPrincipalName
Applicable: SharePoint Online
UserPrincipalName or UPN defined for the specific user on the SPO tenant
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ValidationOnly
Applicable: SharePoint Online
Use this parameter to validate if the user is able to be moved. This parameter is recommended for any user move.
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 |
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.