Use this cmdlet to export a sync tracking table to a file that can be imported to another host, or simply preserved for backup reasons.
PowerShell
Export-TrackingTable
- -SyncTrackingID
- -ExportTo
- [-OverwriteExisting]
Description
Use the Export-TrackingTable to export the tracking information that is stored that links a items and folders from a source store to a target store.
When exporting a tracking table, the table is removed from use by the current host. Attempts to start a sync task that references the source and target store that are part of the tracking table will fail to start; Super-ExMerge stores a pointer to the specific tracking table in the source mailbox. In addition, any sync tasks that are found in the task queue that reference the tracking table are also exported and removed from the task queue into the same -ExportTo folder.
IMPORTANT: A tracking table should only be used on one host at a time in order to avoid duplication of data. The tracking table holds the links between folders and items between a source and target store. Please refer to the TrackingTables documentation as part of the Vocabulary and Glossary for more detail.
Examples
Example 1
PowerShell
$info Get-TrackingInfo | Select -First 1 Export-TrackingTable -SyncTrackingID $info.SyncTrackingID -ExportTo c:\exports
This example will select the first tracking info available and will export the tracking table referenced to the ‘c:\exports’ folder.
Note that the filename of the exported file is automatically chosen and is a combination of the source and target store names. The file can be renamed after export if needed or desired.
Example 2
PowerShell
$info = Get-TrackingInfo | Select -First 1 | Export-TrackingTable -ExportTo c:\exports -OverwriteExisting
This example uses the PowerShell pipeline to select the first tracking info item and passes it to the Export-TrackingTable cmdlet. The -OverwriteExisting switch is used to allow the exported file to be overwritten, if such already exists in the ‘c:\exports’ folder.
Parameters
-SyncTrackingID
The SyncTrackingID parameter specifies the name of the specific tracking table that is to be exported. This value can be retrieved using the Get-TrackingInfo cmdlet.
-ExportTo
The ExportTo parameter specifies the file system folder in which the exported tracking table is created. Any sync tasks in the task queue that reference the tracking table are exported to this folder as well.
The ExportTo parameter accepts either a text value for the folder path, or an already created System.IO.DirectoryInfo object from the .NET Framework.
-OverwriteExisting
The OverwriteExisting switch parameter determines whether an existing export file is overwritten.
