Merge branch 'master' into patch-4

Author: chrisda

sharepoint/sharepoint-ps/sharepoint-online/Start-SPOUserAndContentMove.md

@@ -26,39 +26,39 @@ Start-SPOUserAndContentMove [-UserPrincipalName] <String> [-DestinationDataLocat
 
 ## DESCRIPTION
 
-In a multi-geo company, this cmdlet requires a multi-geo tenant to work, and enables the ability to move a user closer to their sites
+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 ran by a SharePoint or Global administrator, 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 [email protected] -DestinationDataLocation EUR
+Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation EUR
 ```
 
-This example moves the user [email protected] from the current location, to the European location (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 [email protected] -DestinationDataLocation JPN
+Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation JPN
 ```
 
-This example moves the user [email protected] from the current location, to the Japanese location (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 [email protected] -DestinationDataLocation EUR -PreferredMoveBeginDate ((Get-Date).AddHours(1)) -PreferredMoveEndDate ((Get-Date).AddHour(12))
+Start-SPOUserAndContentMove -UserPrincipalName username@contoso.onmicrosoft.com -DestinationDataLocation EUR -PreferredMoveBeginDate ((Get-Date).AddHours(1)) -PreferredMoveEndDate ((Get-Date).AddHour(12))
 ```
 
-This example moves the user [email protected] from the current location, to the European location (EUR), preferred to start 1 hour ahead from now, until 12 hours to that relative time.
+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 new destination of the user that you want to move.
+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. 
 
 ```yaml
 Type: String
@@ -75,7 +75,7 @@ Accept wildcard characters: False
 
 ### -Notify
 
-Makes a SPO notification that the user is being move
+Provides an SPO notification that the user is being moved.
 
 ```yaml
 Type: String
@@ -92,7 +92,7 @@ Accept wildcard characters: False
 
 ### -OverwriteOdb
 
-Switch parameter to Overwrite the information into the DB
+This parameter can be used to overrite a OneDrive in the destination location, if there is one present. This is only recommended in cases where an administrator wants to replace a OneDrive that already exists in the destination location, with the moved OneDrive. 
 
 ```yaml
 Type: SwitchParameter
@@ -109,7 +109,7 @@ Accept wildcard characters: False
 
 ### -PreferredMoveBeginDate
 
-Specifies what is the preferred Date and time to start the job
+Specifies what is the preferred date and time to begin the move. 
 
 ```yaml
 Type: DateTime
@@ -126,7 +126,7 @@ Accept wildcard characters: False
 
 ### -PreferredMoveEndDate
 
-Specifies what is the preferred Date and time to stop the job
+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. 
 
 ```yaml
 Type: DateTime
@@ -141,23 +141,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -Reserved
-
-This parameter will only check for reserved users to be moved near to their sites
-
-```yaml
-Type: String
-Parameter Sets: (All)
-Aliases:
-Applicable: SharePoint Online
-
-Required: False
-Position: 7
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
 ### -UserPrincipalName
 
 UserPrincipalName or UPN defined for the specific user on the SPO tenant
@@ -177,7 +160,7 @@ Accept wildcard characters: False
 
 ### -ValidationOnly
 
-Use this parameter to validate if the user is able to be moved.
+Use this parameter to validate if the user is able to be moved. This parameter is recommended for any user move. 
 
 ```yaml
 Type: SwitchParameter