Chat now with support
Chat with Support

Migrator for Notes to Exchange 4.16 - Program Parameters Reference Guide

About the Migrator for Notes to Exchange documentation Introduction Parameters for Admin Components Parameters for the Self-Service Desktop Migrator (SSDM)

[Filters] section

Type:

Default:

Occurs in:

 

string

none

Data Migr

 

Each line specifies a folder name. The specified folder is excluded from the migration. For example:

[Filters]

Filter0=Folder1

Filter1=Folder2

Folders can be included or excluded by setting [Filters], [FolderTreeFilters], and [IncludeFoldersAndViews]. The precedence order is [Filters] > [IncludeFoldersAndViews] > [FolderTreeFilters].

If a folder is named in both the [Filters] section and the [IncludeFoldersAndViews] section, the [Filters] section takes precedence and the folder or view is not migrated.
If a folder is named in both the [IncludeFoldersAndViews] and the [FolderTreeFilters], the [IncludeFoldersAndViews] sections take precedence and the folder or view is migrated. Since the [FolderTreeFilters] section impacts the sub folders, the sub folders are still excluded if they are not named in the [IncludeFoldersAndViews].

[FolderTreeFilters] section

Type:

Default:

Occurs in:

New in:

string

none

Data Migr

4.15.2

Each line specifies a folder name. The specified folder and all sub folders are excluded from the migration. For example:

[FolderTreeFilters]

Filter0=Folder1\sub1

Filter1=Folder2\sub1

Folders can be included or excluded by setting [Filters], [FolderTreeFilters], and [IncludeFoldersAndViews]. The precedence order is [Filters] > [IncludeFoldersAndViews] > [FolderTreeFilters].

If a folder is named in both the [Filters] section and the [IncludeFoldersAndViews] section, the [Filters] section takes precedence and the folder or view is not migrated.
If a folder is named in both the [IncludeFoldersAndViews] and the [FolderTreeFilters], the [IncludeFoldersAndViews] sections take precedence and the folder or view is migrated. Since the [FolderTreeFilters] section impacts the sub folders, the sub folders are still excluded if they are not named in the [IncludeFoldersAndViews].

[General] section

Type:

Default:

Occurs in:

Updated in:

boolean

1

Data Migr

4.10

... tells the wizard to not manipulate ACLs in any way during the migration. By default (ACLs=1) the wizard will copy ACL information and will set folder permissions in Exchange. New in version 4.10: The ACLs parameter now also determines whether PAB ACLs will be migrated. Prior to this enhancement, PAB ACLs were always migrated regardless of this ACLs=<#> setting.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Tells the Data Migration Wizard whether to migrate Notes server-based AutoForwarding rules to comparable forwarding rules in Exchange, when the rules contain Notes-style addresses instead of SMTP addresses. For example: AllowForwardtoNotesConnector=0 tells the wizard to not migrate rules with Notes-style addresses. This parameter is ignored if MigForwarding=0 (see below).

Type:

Default:

Occurs in:

 

keyword

PST

Data Migr

 

Specifies the destination for migrated archives. Valid values are "PST" or "server".

If ArchiveDest=server, then the ArchiveDestServerArchive parameter (documented separately below) determines whether archives will be migrated to users' server-mail mailboxes or personal-archive mailboxes.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.4.1

Determines whether archives will be migrated to users' server-mail mailboxes (0) or personal-archive mailboxes (1). For example:

… tells the wizard to migrate users' archives to their personal archive mailboxes. Note that this ArchiveDestServerArchive parameter is relevant only if ArchiveDest=server (as documented above). If ArchiveDest=pst, this ArchiveDestServerArchive parameter is ignored.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Determines whether the Select Destinations for Migrated Data screen, in the Data Migration Wizard, will display (1) or hide (0) the Archives drop-down list box. By default (1), the item does appear in the screen, but AskArchiveDest=0 tells the wizard to not show the Archives field in the screen.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

... disables date filtering in the Data Migration Wizard, and tells the wizard to not present the date-filtering options to the user in the GUI. Date filtering lets an admin limit the items migrated by date: no earlier than, no later than, or both. By default this feature is enabled—that is, the date-filtering options do appear available to the user in the GUI.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Determines whether the Select Destinations for Migrated Data screen, in the Data Migration Wizard, will display (1) or hide (0) the Address books drop-down list box. By default (1), the item does appear in the screen, but:

... tells the wizard to not show the Address books field in the screen.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Determines whether the Select Destinations for Migrated Data screen, in the Data Migration Wizard, will display (1) or hide (0) the Server-based data drop-down list box. By default (1), the item does appear in the screen, but:

... tells the wizard to not show the Server-based data field in the screen.

Occurs in: Data Migr. This is an internal scratch parameter (see Transient “scratch” parameters). The wizard notes whether a compiled AddressTranslation.bin file has ever been generated (1=yes, 0=no), and writes the value to this parameter.

Type:

Default:

Occurs in:

New in:

string

[none]

Data Migr

3.2.0

Specifies the path and filename of the text file (*.txt) that contains a customized message that the Data Migration Wizard should insert in place of any attachment that the wizard removes due to a size limitation. The wizard lets you specify a size limit for attachments in migrating messages, so the wizard will remove any attachment that exceeds the limit and replace it wih an explanatory note in the message body. The wizard will insert a default explanatory note unless UseFilteredAttachmentMsg=1 (see below), in which case the wizard will insert the customized message drawn from the text file specified here. If UseFilteredAttachmentMsg=0, the wizard will ignore this AttachmentFilteredbySizeMsg parameter. For example:

... tells the wizard to insert the contents of c:\temp\custom_msg.txt in place of the removed attachment whenever an attachment exceeds the size limit. This feature is also an option in the SSDM (same parameter, but in notesdtapp.ini).

Type:

Default:

Occurs in:

New in:

string

[none]

Data Migr

3.2.0

Specifies the path and filename of the text file (*.txt) that contains a customized message that the Data Migration Wizard should insert in place of an attachment to a migrated encrypted message. When an encrypted message is migrated, the attachment is removed and replaced by an explanatory note. The wizard will insert a default explanatory note unless UseFilteredAttachmentMsg=1 (see below), in which case the wizard will insert the customized message drawn from the text file specified here. If UseFilteredAttachmentMsg=0, the wizard will ignore this AttachmentLostDueToEncryptionMsg parameter. For example:

... tells the wizard to insert the contents of c:\temp\custom_msg.txt in place of the removed attachment in each migrated encrypted message. This feature is also an option in the SSDM (same parameter, but in notesdtapp.ini).

Type:

Default:

Occurs in:

New in:

string

[none]

Data Migr

3.2.0

Specifies the path and filename of the text file (*.txt) that contains a customized message that the Data Migration Wizard should insert in place of the encrypted body of a migrated encrypted message. When an encrypted message is migrated, the encrypted message text is removed from the message body, but is replaced by an explanatory note. The wizard will insert a default message unless UseFilteredBodyMsg=1 (see below), in which case the wizard will insert the customized message drawn from the text file specified here. If UseFilteredBodyMsg=0, the wizard will ignore this BodyLostDueToEncryptionMsg parameter. For example:

... tells the wizard to insert the contents of c:\temp\custom_msg.txt in place of the removed message body in each migrated encrypted message. This feature is also an option in the SSDM (same parameter, but in notesdtapp.ini).

Type:

Default:

Occurs in:

 

string

[none]

NMM

 

This value corresponds to a GUI element in the Notes Migration Manager: the Directory for central log and status files text box (under End-user tool settings) in the Shared Directories Configuration screen. The program writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

keyword

1

NMM

 

This value corresponds to a GUI element in the Notes Migration Manager: the Log level radio buttons for End-user tool settings in the Shared Directories Configuration screen. The value specifies how much detail the program will include in its run logs. Valid values are single digits, 0 x 3. The default value 1 is suitable for most routine production runs. If you need to diagnose a problem, set the value to 3 (verbose). The GUI offers two radio-button options that correspond to these numeric parameter values:

The program writes this value to the Task Parameters from an administrator’s GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

0

NMM

3.2

Tells the program whether to compress its log file. A compressed log file saves disk space, and is viewable by Quest's Log Viewer utility, but is not a generic text file that can be viewed in Notepad or Word. This is a binary parameter; the only valid values are 0 (off) or 1 (on). For example: CompressLogFile=1 tells the program to compress the file.

Type:

Default:

Occurs in:

New in

keyword (single digit 0, 1, 2, or 3)

1

Data Migr

4.14.1

Determines how contacts are displayed in Outlook. The options for this setting are:

2 – Create the display name as FirstName LastName. The middle name and name suffix are included, if present.
3 – Create the display name as LastName, FirstName. The middle name is included, if present.

Type:

Default:

Occurs in:

 

string

Notes

Data Migr

 

Determines how users’ primary Contacts folders are named. For example:

... tells the wizard to name each user’s primary Contacts folder “MyContacts.”

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Determines whether the Data Migration Wizard will display its Check for Outlook Folders prompt if it cannot identify the necessary Outlook folder names during the wizard’s test to verify valid access to servers. (The wizard tests server access by attempting to send a dummy message to the mailbox of the first user assigned to each server within the collection. If the wizard cannot identify the destination Outlook folder—for example, if the folder names have been localized to another language—this prompt asks the admin to correct the localized names in the configuration before continuing with the test.) By default (1) this prompt will appear as described above. If you disable the prompt by:

... the wizard will not display the prompt, and the migration will likely generate server-access errors.

Type:

Default:

Occurs in:

New in:

date

now

Data Migr

4.16.0

Supports the Domino feature that allows you to schedule messages to be sent on a specific date and time. After migration, Exchange or Exchange Online will not send the deferred messages.

Specifies the earliest date that deferred emails (sent items that are timestamped on or after that date) will be written to a log file (named XXX-DeferredEmails.tsv) located in the MNE log folder. If the parameter is not set, only deferred messages that have a date after NOW are written to the log file. If you plan to shut down the Domino server on a specific day after the migration, it is recommended that you set the parameter to be on or before that day. This provides you with a list of deferred emails that were not delivered by Domino.

Type:

Default:

Occurs in:

New in:

boolean

15

Data Migr

4.15.2

Tells the Data Migration process to update user statistics after an interval of 15 seconds (default). The minimum supported interval value is 5 seconds.

The User Migration Status window displays real-time user statistics. Open the window from the Task Progress and Task Completed pages of the Data Migration Wizard by clicking User Status.

Type:

Default:

Occurs in:

New in:

boolean

0

All logging applications and Log Viewer

4.15.2

Specifies if the program caches and writes out 128 DEBUG log lines before a WARNING or ERROR when LogLevel is less than or equal to 2. When LogLevel equals 3, the debug log is always written out.

When set to the default value (0), the debug pool is enabled and the program caches up to 128 DEBUG log lines. The program writes out the previous 128 DEBUG log lines when it meets a WARNING or ERROR.

Set DisableDebugPool=1 if you don't want the previous DEBUG log to be written out before a WARNING or ERROR when LogLevel is less than or equal to 2.

Type:

Default:

Occurs in:

New in:

boolean

[GUI entry]

Data Migr

4.1

This value corresponds to a GUI element in the Data Migration Wizard: the Manage mail routing checkbox in the Operations screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Notes administrative functions checkbox in the Operations screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Occurs in: Data Migr. This is an internal scratch parameter (see Transient “scratch” parameters).

Type:

Default:

Occurs in:

 

string

[none]

NMM

 

This value corresponds to a GUI element in the Notes Migration Manager: the Common application directory text box (under Common tool settings) in the Shared Directories Configuration screen. The program writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

string

[none]

NMM, Usr Stats

 

This value corresponds to a GUI element in the Notes Migration Manager: the End-User statistics directory text box in the Gather End-User Statistics screen. The program writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

keyword

Same

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Set contact ‘File as’ to drop-down listbox in the Specify Data for Migration screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

The FileAsFormat parameter determines the format of the contact’s File As attribute in Exchange. The File As attribute is used by Outlook to alphabetize your contacts. The options for this setting are:

Same: Use the Display Name attribute of the address book entry. By default Migrator for Notes to Exchange migrates contacts using display names that match the display name of the contact in Notes, however the contact’s display format can be modified using the [General] ContactDisplayNameFormat parameter.
FirstLast: Create the File As using the first name and last name attributes separated by a space. The middle name and name suffix are included, if present.
LastFirst: Create the File As using the last name and first name attributes separated by a comma. The middle name is included, if present.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1, or 2)

[varies; see below]

Data Migr

4.5

Determines which method the wizard will use for Active Directory mail forwarding. The parameter value is a single-digit integer, which must be one of these three valid values:

Note that this ForwardingMethod parameter replaces the previous UseHiddenADContact boolean parameter, which is deprecated as of version 4.5.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1, 2 or 3)

3

Data Migr

3.2

Tells the Data Migration Wizard to migrate Notes DocLinks to Exchange in a particular link format. For example:

... tells the wizard to migrate DocLinks to Exchange as HTML-style links. Valid parameter values are:

2: Migrate DocLinks in the Notes Migrator for SharePoint format. In this case you must also use the SharePointServerName parameter (also in this [General] section) to specify the name of the server where the linked documents reside. (This SharePoint format option added in ver 4.1.2.)

For an off-line migration, this parameter must be set to HTMLdoclinks=0.

Type:

Default:

Occurs in:

New in:

string

[null]

Data Migr

4.12.0

Specifies which set of folder names the Data Migration Wizard should use when assigning folder names to Outlook PST and personal archive folders. The wizard's Task Parameters may contain several sets of PST and personal archive folder names for different locales, differentiated by different [SECTIONNAME]s for the different locales. This parameter simply specifies the name of the locale section that contains the locale-specific PST and personal archive folder names you want the wizard to use for this purpose:

The default is null, in which case the wizard uses the section associated with the system locale (of the computer running the wizard). But if (for example) LanguageCode=DE, the wizard will use the PST and personal archive folder names defined in the [DE] section of the Task Parameters. Note that there must exist a language section in the Global Defaults to support the SECTIONNAME you specify.

Type:

Default:

Occurs in:

New in:

string

%temp%

all logging apps, and Log Vwr

3.2

Tells the program where to write its log file. The parameter can specify either a UNC shared directory or a local drive. For example:

... tells the program to write its log file to the \\server\share\ folder. By default, if the parameter is unspecified, the program writes its log file as notesdtapp.wlog, to whatever path is associated with the %temp% environment variable. If some other path is specified by this parameter, the filename will be: COMPUTERNAME-yyyymmdd-hhmmss.wlog.

Type:

Default:

Occurs in:

 

keyword

2

all logging apps, and Log Vwr

 

Specifies how much detail the program will include in its run logs. Valid values are single digits, 0 x 3. The default value 2 is suitable for most routine production runs. If you need to diagnose a problem, set the value to 3 (verbose): LogLevel=3

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.12.1

Determines whether the Data Migration Wizard's log entries and stats counts for unmigrated items will (1) or will not (0) include appointment responses that were skipped by configuration—by setting [Notes] MigrateAppointmentResponses=0. (See the entry for MigrateAppointmentResponses=<#>, in the [Notes] section below, for more information about this other option.)

Type:

Default:

Occurs in:

 

integer

450

Data Migr

 

Specifies the number of folders to cache before flushing the cache. Exchange limits the number of objects that can be open at one time. The limit for folders is 500, so if a user has more than 500 folders, the default setting of MaxFolderCache=450 will tell the Data Migration Wizard to flush the cache at 450, so all folders will migrate.

Valid values are 0 x max, where the maximum value is one less than the maximum folder count that is configured on your Exchange server in the registry settings. See this Microsoft article.

If this cache flush feature is turned off (by MaxFolderCache=0, so that the cache is unlimited), and a user has more than 500 folders, the folders will not be created, and the wizard will note an error in the log.

Type:

Default:

Occurs in:

 

integer

20480

Data Migr

 

Specifies the maximum size (in MBs) of large PSTs (Outlook 2003 or later Unicode PST files), beyond which the Data Migration Wizard will split the file into two or more files. For example:

This parameter is ignored for users running Outlook 2002 or earlier. Valid values are 0 x 51200 for Outlook 2010, or 0 x 20480 for earlier Outlook versions. (Note that pre-2010 versions of Outlook cannot open a file larger than 20 MB.)

Type:

Default:

Occurs in:

 

integer

2048

Data Migr

 

Specifies the maximum size (in MBs) of PSTs (for Outlook 2002 and earlier PST files), beyond which the Data Migration Wizard will split the file into two or more files. Valid values are 0 x 2048.

Type:

Default:

Occurs in:

 

string

Contacts

Data Migr

 

The name of the single folder to which the Data Migration Wizard will merge all migrated address books, if you want to migrate them to a folder other than the default Contacts folder. For example:

This parameter is ignored if MergeAddressBooks=0.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

MergeAddressBooks=1 tells the wizard to merge all migrated address books into the single Contacts folder, or into a single folder as named by the MergeAddressBookFolder parameter (see above). When MergeAddressBooks=0, the program will migrate different address books to different folders, one folder per address book.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Tells the Data Migration Wizard whether to migrate Notes server-based AutoForwarding rules (if any) to become comparable forwarding rules in Exchange. For example:

... disables the migration of server-based forwarding rules. By default (MigForwarding=1) the wizard will migrate Notes forwarding rules. If the Notes forwarding address is a Notes-style address, the address will be added in Exchange as a Notes address only if AllowForwardtoNotesConnector=1.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate users checkbox in the Operations screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate archives checkbox in the Specify Data for Migration screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate personal address books checkbox in the Specify Data for Migration screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.7

MigrateRecentContacts=1 tells the wizard/SSDM to migrate the PABs' Recent Contacts list to the folder specified by the RecentContactsFolder parameter.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.1.5

Determines whether the wizard will (1) or will not (0) migrate all instances of a recurring appointment or task when the first instance occurs prior to the range of a specified date filter (if any has been defined), but the last instance occurs within or after the date filter range. For example, if a date filter had been defined to migrate only mail and calendar items from October 10 through 25, and a recurring weekly appointment or task has been defined to run three weeks beginning October 1 (so appointments occur on October 1, 8 and 15), then:

… would tell the wizard to migrate all three instances of the series. Likewise, if the same October 10-25 date filter were defined, and a recurring weekly appointment spanned five weeks beginning October 1 (for instances on October 1, 8, 15, 22 and 29), then MigrateRecurringBeforeRange=1 would migrate all five instances.

If MigrateRecurringBeforeRange=0, none of the instances of a recurring appointment or task are migrated if the first instance of the series occurs prior to the range of a defined date filter.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate mail data checkbox in the Specify Data for Migration screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

integer

100

Data Migr

 

The minimum disk space, in MB, that must be available on the admin’s migration server for the Data Migration Wizard to run. For example, if:

... and the available disk space on the migration server is only 180MB, the wizard will display an error message and abort its run.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1, 2, 4 or 7)

0

Data Migr

4.1.5

Tells the Data Migration Wizard which types of messages to migrate, depending on the features of each message. The parameter value must be one of these single-digit numeric keywords:

For example: MsgRequireAnyFeature=2 tells the wizard to migrate only messages with inline MIME attachments.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.16.0

When set to (1), the MNE console navigation drawer displays the option Upgrade Templates. When selected, MNE upgrades all the full templates in the database to differential templates. Differential templates pick up changes made to the Global Default settings.

After the templates have been upgraded, the parameter is set to (0). You should not configure this parameter directly, it is set by program.

Type:

Default:

Occurs in:

 

keyword

server

Data Migr

 

The destination for migrated Personal Address Books data. Valid values are "PST" or "server". For example:

If PABDest=server, then the PABDestServerArchive parameter (documented separately below) determines whether PABs will be migrated to users' server-mail mailboxes or personal-archive mailboxes.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.4.1

Determines whether PABs will be migrated to users' server-mail mailboxes (0) or personal-archive mailboxes (1). For example: PABDestServerArchive=1 tells the wizard to migrate users' PABs to their personal-archive mailboxes. Note that this PABDestServerArchive parameter is relevant only if PABDest=server (as documented above). If PABDest=pst, this PABDestServerArchive parameter is ignored.

Type:

Default:

Occurs in:

 

boolean

1

NMM

 

This value corresponds to a GUI element in the Notes Migration Manager: the Post user logs to the central directory checkbox in the Shared Directories Configuration screen. The program writes the value from an admin's GUI entry to the NMM Task Parameters, and also (the same value) to a corresponding PostLogs parameter and a SendStatus parameter in the [General] section of the notesdtapp.ini file (for the SSDM). (For more information, see the PostLogs and SendStatus parameters in the notesdtapp.ini pages of this Reference.) Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.16.0

When set to (1), MNE prompts the user to upgrades all the full templates in the database to differential templates when the MNE console is launched. Differential templates pick up changes made to the Global Default settings.

After the templates have been upgraded or the customer selects “Don’t ask me again”, the parameter is set to (0). You should not configure this parameter directly, it is set by program.

These several parameters together configure Migrator for Notes to Exchange proxy settings, to better facilitate connections to Office 365 and other hosted platforms when using a proxy server to connect to the Internet. These parameters pertain only to PowerShell operations, and also require that MAPI proxy access be configured through Windows’ Internet Options dialog box. This Quest KnowledgeBase article explains how to configure a proxy server in Windows that will allow Migrator for Notes to Exchange to connect to Office 365.

Introduced in version 4.5.2, these parameters occur in the Provisioning Wizard and Data Migration Wizard.

Note that not all enumerations of AuthenticationMechanism or AccessType are supported by the PSSessionOption object (according to PowerShell documentation). Supported values are listed here.

ProxyAccessType can be set to any of these values:

ProxyAuthMechanismType can be set to any of these values:

ProxyUserName must also be specified for some types of authentication.

~ProxyPassword must also be specified for some types of authentication.

Occurs in: Data Migr. This is an internal scratch parameter (see Transient “scratch” parameters).

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.1.1

Tells the Data Migration Wizard whether to migrate Notes' "send on behalf of" delegation rights. The wizard migrates these rights by default (1), but this feature can be disabled by: PublicDelegates=0

Type:

Default:

Occurs in:

New in:

string

Recent Contacts

Data Migr

4.7

Specifies the name of the folder to which the PAB’s Recent Contacts list will be migrated. This parameter is ignored if MigrateRecentContacts=0.

Type:

Default:

Occurs in:

New in:

boolean

0

Q Sched

4.6

Determines whether Migrator for Notes to Exchange's scheduling application (Qsched.exe) will reset recurring work items back to a "ready" state upon launch. Before this parameter was introduced, the reset was automatically applied and sometimes caused users to migrate multiple times. The default (ResetMigAppWorkItems=0) does not reset work items to a "ready" state for recurring tasks. To enable the feature (the behavior in earlier releases), set ResetMigAppWorkItems=1. Quest recommends this feature always be disabled (0) if you are attempting a balanced migration across multiple machines.

Type:

Default:

Occurs in:

New in:

Deprecated in:

boolean

0

Q Sched

4.5.4

4.9.0

Determines whether Migrator for Notes to Exchange's scheduling application (QSched.exe) will run as a service, which in turn loads the MAPI subsystem in a "running as service" context, so MAPI will not try to display a log-in prompt to the user. For example, RunAsService=1 tells QSched to run as a service. By default (0), QSched will not run as a service—as in prior Migrator for Notes to Exchange releases.

When running as a service, MAPI uses the credentials of the currently logged-in user (in this case, the account under which the service is running). When running Migrator for Notes to Exchange this way, the service must be running as the Exchange user normally configured in the Migrator for Notes to Exchange console.

Due to changes in the scheduling service, this parameter is deprecated in version 4.9.0 and higher.

Type:

Default:

Occurs in:

 

keyword

server

Data Migr

 

Sets the destination for migrated server mail. Valid values are "PST" or "server". For example:

If ServerMailDest=server, then the ServerMailDestServerArchive parameter (documented separately below) determines whether server mail will be migrated to users' server-mail mailboxes or personal-archive mailboxes.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.4.1

Determines whether server mail will be migrated to the users' server-mail mailboxes (0) or personal-archive mailboxes (1). For example: ServerMailDestServerArchive=1 tells the wizard to migrate users' server mail to their personal-archive mailboxes.

Note that this ServerMailDestServerArchive parameter is relevant only if ServerMailDest=server (as documented above). If ServerMailDest=pst, this ServerMailDestServerArchive parameter is ignored.

Type:

Default:

Occurs in:

 

string

[none]

Data Migr

 

Specifies the name of the SharePoint server where the Proposion-linked documents reside, if HTMLdoclinks=2 (in this same [General] section). For example:

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

3.2.0

Determines whether the Data Migration Wizard will (1) or will not (0) display an optional set of fields, on its Select Notes Administrative Operations screen, that let the admin set the domain values for the source mail domain, calendar domain, and mail system. For example:

... tells the wizard to display the fields. When ShowSetMailDomain=1, these other parameters (in the [Notes] section of these parameter settings) may be used to set the default values for the corresponding fields:

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.1.5

Determines whether the wizard will (0) or will not (1) migrate an exception to a recurring appointment or task when the original or rescheduled start time falls outside the range of a defined date filter (if any). This parameter does not control whether such an instance would be migrated at all, but only whether the instance would be migrated as originally scheduled, or as it was changed. If, for example:

… and one instance of a recurring series was originally scheduled for October 1 but had been changed to October 2, and if that instance occurs outside a defined date filter range, then the wizard will skip the exception—i.e., will migrate the instance at its original October 1 time rather than as changed, to October 2. If SkipOutOfRangeExceptions=0 (default), then the wizard would migrate the instance as changed, for October 2.

Type:

Default:

Occurs in:

string

[none]

NMM, Dir Exp, Data Loc, PAB Replic, Data Migr

Specifies the path and filename of the SMTP Translation Table: a data file generated by the Directory Export Wizard and used by other Quest applications and wizards to convert addresses in messages, address books, and contacts to the appropriate Internet (SMTP) address for each user. The Directory Export Wizard writes this value to the Task Parameters automatically; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

string

[none]

Data Migr

 

This value, automatically generated from values in the SQL Server Configuration screen of Notes Migration Manager, is used by the Data Migration Wizard to access necessary licensing information during the migration process. Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

integer

[none]

Data Migr

 

This value, representing the number of simultaneous processes the program will use to perform migrations, corresponds to a GUI element in the Data Migration Wizard: the Number of migration threads field in the Specify Migration Run Information screen. The wizard writes this value to the Task Parameters from an admin's GUI entry; Quest recommends you do not manually enter or change the value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

3.2.0

Determines whether the Data Migration Wizard will insert a default message (0) or a customized message (1) to replace an attachment that the wizard has removed from a migrating message because it is encrypted or because the attachment exceeds a size limit. The wizard removes such an attachment from a migrating message, and replaces it with an explanatory note. The explanatory note can be either a default explanation, or some customized message from a text file specified by a separate parameter (either AttachmentLostDueTo­EncryptionMsg or AttachmentFilteredbySizeMsg, as described above).

For example, UseFilteredAttachmentMsg=1 tells the wizard to insert the customized message. This feature is also an option in the SSDM (same parameter, but in notesdtapp.ini).

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

3.2.0

Determines whether the Data Migration Wizard will insert a default message or a customized message to replace the encrypted body of a migrated encrypted message. The wizard removes the message body from every encrypted message it migrates, and replaces it with an explanatory note. The explanatory note can be either the default ("An encrypted bodypart was discarded"), or some customized message from a text file specified by the separate BodyLostDueToEncryptionMsg parameter (see above). For example:

... tells the wizard to insert the customized message. This feature is also an option in the SSDM (same parameter, but in notesdtapp.ini).

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

UseLargePsts=0 forces the program to not use large PSTs, whereas by default (1) the program will use large PSTs if possible. Note: A setting of 1 will not force Unicode PSTs if Outlook 2003 or later is not installed. The program cannot create PSTs without the proper MAPI components (from Outlook 2003 or later) in place.

Occurs in: Data Migr. This is an internal scratch parameter (see Transient “scratch” parameters).

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

... tells the wizard to migrate all data into a single pst file per user. The default is 1, so data is migrated into multiple psts.

Type:

Default:

Occurs in:

Default changed in:

integer

180

Data Migr

4.7

Specifies the number of minutes of inactivity the Data Migration Wizard will wait within a program run before assuming a process has encountered a fatal error, and aborting the process. For example: WatchdogMinutes=60

Migration to hosted platforms often generates more process timeouts than migration to a local server, particularly when migrating quantities of large messages (usually due to large attachments). We therefore recommend the default watchdogminutes=180 for connections to Office 365, to make the migration program "forgiving." A substantially lower setting of, say, watchdogminutes=30 might be better suited to migration to a local server, where shorter and higher-quality transmission paths make timeouts less common.

A value of 0 tells the wizard to wait indefinitely (forever) for activity, rather than reporting a fatal error has occurred after some period of time.

Type:

Default:

Occurs in:

 

integer

10

Data Migr

 

Specifies the number of seconds the Data Migration Wizard will wait before restarting a migration which has encountered MAPI errors specified in the MAPIErrorsToRetry parameter. For example:

[IncludeFoldersAndViews] section

Type:

Default:

Occurs in:

New in:

string

none

Data Migr

4.15

Each line specifies a folder or view name. The specified folder or view is included with the migration. For example:

[IncludeFoldersAndViews]

Include0=My Folder

Include1=My View

Folders can be included or excluded by setting [Filters], [FolderTreeFilters], and [IncludeFoldersAndViews]. The precedence order is [Filters] > [IncludeFoldersAndViews] > [FolderTreeFilters].

If a folder is named in both the [Filters] section and the [IncludeFoldersAndViews] section, the [Filters] section takes precedence and the folder or view is not migrated.
If a folder is named in both the [IncludeFoldersAndViews] and the [FolderTreeFilters], the [IncludeFoldersAndViews] sections take precedence and the folder or view is migrated. Since the [FolderTreeFilters] section impacts the sub folders, the sub folders are still excluded if they are not named in the [IncludeFoldersAndViews].
Related Documents