DateTo and DateFrom

Description

DateTo and DateFrom are Simply Migrate Job configuration settings.  They are applied to a Job to discover, migrate or report on the source data with the appropriate date filter applied.

What it means

DateTo (Format yyyy-MM-dd)
As the name implies, the DateTo Job parameter can be used to set a date filter, either alone, or in tandem with the DateFrom parameter.  Setting this parameter alone will report, discover or migrate all data UP TO midnight of the specified date.

DateFrom (Format yyyy-MM-dd)
Inverse to DateTo, setting a value to the DateFrom parameter will discover, report and migrate only data NEWER than the date set.

Examples

This example shows the use of DateTo and DateFrom used together in a Job configuration.  The following job will discover all data in an Office 365 mailbox between midnight (At the start of the day) of the first of March 2018 – up until midnight (At the end of the day) of the the 13th March 2018.

New-SmJob -Source Exchange -SourceInput user@domain.com -SourceCredential $Creds -SourceOptions Ex2016 -SourceEWSUrl (Get-SmDefaultO365EwsUrl) -DateFrom 2018-03-01 -DateTo 2018-03-13 -Target ReportOnly -BatchId 1 -Tags "March 2018 Discovery"

To apply a date filter for all items older than a specified date, simply omit the DateFrom parameter.  The following example will report on all data in an Office 365 mailbox that is older than midnight (End of the day) of the 13th March 2018.

New-SmJob -Source Exchange -SourceInput user@domain.com -SourceCredential $Creds -SourceOptions Ex2016 -SourceEWSUrl (Get-SmDefaultO365EwsUrl) -DateTo 2018-03-13 -Target ReportOnly -BatchId 1 -Tags "March 2018 Discovery"