Skip to content

Commit 3f67e54

Browse files
MicrosoftHeidiMicrosoftHeidi
authored
Merge pull request #28245 from MicrosoftDocs/heidip-freshness-spring-2025
Heidip freshness spring 2025
2 parents 088e473 + cda8f5a commit 3f67e54

1 file changed

Lines changed: 35 additions & 35 deletions

File tree

‎microsoft-365/enterprise/cross-tenant-onedrive-migration-step6.md‎

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: OneDrive Cross-tenant OneDrive migration Step 6
33
ms.author: heidip
44
author: MicrosoftHeidi
55
manager: jtremper
6-
ms.date: 10/13/2023
6+
ms.date: 04/15/2025
77
recommendations: true
88
audience: ITPro
99
ms.topic: how-to
@@ -16,24 +16,25 @@ ms.collection:
1616
search.appverid: MET150
1717
description: "Step 6 of the OneDrive Cross-tenant migration feature"
1818
---
19+
1920
# Step 6: Start a OneDrive cross-tenant migration
2021

21-
This is Step 6 in a solution designed to complete a Cross-tenant OneDrive migration. To learn more, see [Cross-tenant OneDrive migration overview](cross-tenant-onedrive-migration.md).
22+
This article is Step 6 in a solution designed to complete a Cross-tenant OneDrive migration. To learn more, see [Cross-tenant OneDrive migration overview](cross-tenant-onedrive-migration.md).
2223

2324
- Step 1: [Connect to the source and the target tenants](cross-tenant-onedrive-migration-step1.md)
2425
- Step 2: [Establish trust between the source and the target tenant](cross-tenant-onedrive-migration-step2.md)
25-
- Step 3: [Verify trust has been established](cross-tenant-onedrive-migration-step3.md)
26-
- Step 4: [Precreate users and groups](cross-tenant-onedrive-migration-step4.md)
26+
- Step 3: [Verify trust is established](cross-tenant-onedrive-migration-step3.md)
27+
- Step 4: [Precreate users and groups](cross-tenant-onedrive-migration-step4.md)
2728
- Step 5: [Prepare identity mapping](cross-tenant-onedrive-migration-step5.md)
2829
- **Step 6: [Start a Cross-tenant OneDrive migration](cross-tenant-onedrive-migration-step6.md)**
2930
- Step 7: [Post migration steps](cross-tenant-onedrive-migration-step7.md)
3031

3132
>[!IMPORTANT]
3233
>Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
3334
34-
Now you're ready to start your OneDrive migration. Before starting any cross-tenant migration, do the following steps.
35+
Now you're ready to start your OneDrive migration. Before starting any cross-tenant migration, do the following steps.
3536

36-
1. Ensure you have verified the compatibility status. If you see a status of either **Compatible** or **Warning** on your source tenant, you can continue. Run:
37+
1. Make sure you verified the compatibility status. If you see a status of either **Compatible** or **Warning** on your source tenant, you can continue. Run:
3738

3839
```powershell
3940
Get-SPOCrossTenantCompatibilityStatus –PartnerCrossTenantHostURL [Target tenant hostname]
@@ -42,40 +43,39 @@ Now you're ready to start your OneDrive migration. Before starting any cross-te
4243
2. To start the migration, a SharePoint Admin or Microsoft 365 Global Admin of the source tenant must run the following command:
4344

4445
```PowerShell
45-
Start-SPOCrossTenantUserContentMove -SourceUserPrincipalName <...> -TargetUserPrincipalName <...> -TargetCrossTenantHostUrl <...>
46+
Start-SPOCrossTenantUserContentMove -SourceUserPrincipalName <...> -TargetUserPrincipalName <...> -TargetCrossTenantHostUrl <...>
4647
```
4748

48-
|Parameters|Description|
49-
|---|---|
50-
|SourceUserPrincipalName|User principal name of the user who owns the OneDrive on the Source tenant.|
51-
|TargetUserPrincipalName|User principal name of the user who owns the OneDrive on the Target tenant.|
52-
|TargetCrossTenantHostUrl|The Cross-tenant Host URL of the target tenant. To find the TargetCrossTenantHostUrl, run *Get-SPOCrossTenantHostUrl* on the tenant.|
49+
|Parameters |Description |
50+
|-------------------------|------------|
51+
|SourceUserPrincipalName |User principal name of the user who owns the OneDrive on the Source tenant. |
52+
|TargetUserPrincipalName |User principal name of the user who owns the OneDrive on the Target tenant. |
53+
|TargetCrossTenantHostUrl |The Cross-tenant Host URL of the target tenant. To find the TargetCrossTenantHostUrl, run *Get-SPOCrossTenantHostUrl* on the tenant. |
5354

5455
Example:
5556

5657
```Powershell
57-
Start-SPOCrossTenantUserContentMove -SourceUserPrincipalName [email protected] -TargetUserPrincipalName
58-
[email protected] -TargetCrossTenantHostUrl https://m365x946316-my.sharepoint.com/
58+
Start-SPOCrossTenantUserContentMove -SourceUserPrincipalName [email protected] -TargetUserPrincipalName [email protected] -TargetCrossTenantHostUrl https://m365x946316-my.sharepoint.com/
5959
```
6060

61-
To Schedule a migration for a later time, you can use and append the above command with the one of the following parameters.
61+
To Schedule a migration for a later time, you can use and append the previous command with the one of the following parameters:
6262

63-
These commands can be useful when planning bulk batches of OneDrive migrations. You can queue/migrate up to 4,000 OneDrive migrations per batch. If your user count exceeds 4,000, create separate batches, and schedule them to run once the current batch is close to completion.
63+
|Parameter |Description |
64+
|-----------------------|------------|
65+
|PreferredMoveBeginDate |The migration likely begins at this specified time. Time must be specified in Coordinated Universal Time (UTC). |
66+
|PreferredMoveEndDate |The migration likely completes by this specified time, on a best effort basis. Time must be specified in Coordinated Universal Time (UTC). |
6467

65-
|Parameter|Description|
66-
|---|---|
67-
|PreferredMoveBeginDate|The migration will likely begin at this specified time. Time must be specified in Coordinated Universal Time (UTC).|
68-
|PreferredMoveEndDate|The migration will likely be completed by this specified time, on a best effort basis. Time must be specified in Coordinated Universal Time (UTC).|
68+
These commands can be useful when planning bulk batches of OneDrive migrations. You can queue/migrate up to 4,000 OneDrive migrations per batch. If your user count exceeds 4,000, create separate batches, and schedule them to run once the current batch is close to completion.
6969

7070
## OneDrive status premigration
7171

72-
Before you start the migration, the users current source OneDrive status is similar to the example below. This example is from the users source tenant, showing their current files and folders.
72+
Before you start the migration, the users' current source OneDrive status is similar to the following screenshot. This example is from the users' source tenant, showing their current files and folders.
7373

74-
:::image type="content" source="../media/cross-tenant-migration/t2t-onedrive-status-premigration.png" alt-text="pre-migration status":::
74+
:::image type="content" source="../media/cross-tenant-migration/t2t-onedrive-status-premigration.png" alt-text="A screenshot showing a premigration status. There are files and folders displayed in a window, and a red box is drawn around the address of the OneDrive.":::
7575

7676
## Cancelling a OneDrive migration
7777

78-
You can stop the cross-tenant migration of a user's OneDrive by using the following command, provided the migration doesn't have a status of *In Progress*, *Rescheduled* or *Success*.
78+
You can stop the cross-tenant migration of a user's OneDrive by using the following command, provided the migration doesn't have a status of *In Progress*, *Rescheduled*, or *Success*.
7979

8080
```powershell
8181
Stop-SPOCrossTenantUserContentMove – SourceUserPrincipalName [UPN name of user who you wish to stop]
@@ -100,7 +100,7 @@ Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL [Target URL]
100100
Example:
101101

102102
```Powershell
103-
Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL https://m365x946316-my.sharepoint.com/
103+
Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL https://m365x946316-my.sharepoint.com/
104104
```
105105

106106
**Target command:**
@@ -112,7 +112,7 @@ Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL [Source URL]
112112
Example:
113113

114114
```powershell
115-
Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL https://m365x016551-my.sharepoint.com/
115+
Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL https://m365x016551-my.sharepoint.com/
116116
```
117117

118118
To find the status of a specific user's migration, use the *SourceUserPrincipalName* parameter:
@@ -137,20 +137,20 @@ Get-SPOCrossTenantUserContentMoveState -PartnerCrossTenantHostURL https://ttestt
137137

138138
## Migration States
139139

140-
|Status|Description|
141-
|---|---|
142-
|NotStarted|The migration hasn't yet started.|
143-
|Scheduled|The migration is now in the queue and is scheduled to run when a slot becomes available.|
144-
|ReadytoTrigger|The Migration is in its preflight stage and will start the Migration shortly.|
145-
|InProgress|The migration is in progress in one of the following states: </br>- Validation </br>- Backup </br>- Restore </br>- Cleanup|
146-
|Success|The Migration completed successfully.|
147-
|Rescheduled|The migration may not have completed and has been requeued for another pass.|
148-
|Failed|The migration failed to complete.|
140+
|Status |Description |
141+
|---------------|------------|
142+
|NotStarted |The migration isn't started.|
143+
|Scheduled |The migration is now in the queue and is scheduled to run when a slot becomes available.|
144+
|ReadytoTrigger |The Migration is in its preflight stage. The Migration starts shortly. |
145+
|InProgress |The migration is in progress in one of the following states: </br>- Validation </br>- Backup </br>- Restore </br>- Cleanup |
146+
|Success |The Migration completed successfully. |
147+
|Rescheduled |The migration may not be completed and is requeued for another pass. |
148+
|Failed |The migration failed to complete. |
149149

150150
## Post-migration status checks
151151

152152
**Target tenant**: After the migration successfully completes, check the status of the user on the target tenant by logging into their new OneDrive account.
153153

154-
**Source tenant**: Since the user has successfully migrated to the target tenant, they no longer have an active OneDrive account on the source.
154+
**Source tenant**: Since the user was successfully migrated to the target tenant, they no longer have an active OneDrive account on the source.
155155

156156
## Step 7: [Post migration steps](cross-tenant-onedrive-migration-step7.md)

0 commit comments

Comments
 (0)