Note: Copy private chats requires a ShareGate Migration Pro or Migration Ultimate package. It is not available with Migration Essentials Mailbox or Migration Essentials Files.
Use Copy private chats to copy Microsoft Teams private chats from a source tenant to a destination tenant in ShareGate Migrate or with PowerShell.
Before you run a copy, we recommend reviewing Copy private chats - Limitations to know what to expect, and Copy private chats - Best practices to get the most complete result.
Prerequisites
A Microsoft 365 global admin must consent to the ShareGate Migrate - Private Chat permission set before you copy private chats. For the permissions it includes, see Microsoft 365 permission sets required for ShareGate.
Your source and destination are two different tenants.
If ShareGate Migrate asks for additional consent, a global admin can click Re-consent with Microsoft to grant it.
Copy your private chats
Select Copy from the sidebar.
Select the Copy private chats tile.
Connect your source and destination tenants.
You can't copy private chats within the same tenant.
Confirm the user mapping and select the users whose chats you want to copy.
ShareGate automatically maps your source users to matching destination users. You can review and modify these mappings.
Use the search bar to find specific users.
Use the All, Match found, and Warnings filters to review your mappings.
Use Export user mappings and Import user mappings to work from a mapping file.
Use the Checkmark field to select your users or select the top-most checkmark to select or deselect all your users.
Click Continue to copy options.
If some users aren't mapped, ShareGate Migrate warns you that it skips every chat that includes an unmapped user. Click Review mappings to fix them, or Continue anyway.
Choose how much chat history to copy.
Under Select range, select Everything, Last 30 days, or From a start date.
Click Review, then review the summary of your operation.
Click Export list to download the list of selected users.
Click Start copy.
The migration report opens, where you can track your copy's progress.
Click Export report to download a detailed report of the copy operation to your drive. You can always retrieve your summary and detailed report from Tasks in ShareGate Migrate.
Detailed copy report
The detailed report lets you review any warnings or errors that occurred during your migration so that you can resolve them for your users. For a live view of your migration without leaving ShareGate Migrate, see Copy private chats - In-app migration report.
Incremental copy
Copy private chats doesn't have a dedicated incremental copy button. To run an incremental copy, start again from the Copy private chats tile and select the same users.
Copy private chats with PowerShell
You choose the users whose chats you want to copy, map them from the source tenant to the destination tenant, set your copy options, and then run the copy. Each step has its own cmdlet.
Get-ChatUser finds the users whose chats you want to copy.
Export-UserMappings and Import-UserMappings create and load the file that maps source users to destination users.
New-ChatCopyOptions sets the options for the copy, such as the start date of the chats.
Copy-Chat runs the copy.
