지금 지원 담당자와 채팅
지원 담당자와 채팅

Migrator for Notes to Exchange 4.15.2 - 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)

[ErrorsToIgnore] section

Type:

Default:

Occurs in:

string

[none]

AD Grps, Prov, Dir Exp, Data Loc, NABs Disc, Doms Disc, Data Migr, PAB Replic

Each Error<#> parameter identifies a single particular runtime error that the wizard or program should ignore when documenting its activities and outcomes in its log file. Each parameter value:

For example:

The digit(s) appended to an Error<#> key name arbitrarily differentiate one parameter from another. Multiple Error<#> parameters need not appear in numerical order, need not form an uninterrupted numeric sequence, and need not begin at 0. But the wizard will read only Error<#> parameters whose differentiating digits are within the range 0-99 inclusive.

[Exchange] section

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.15.1

When migrating to Office 365, MNE will check to see if the Migration Account (or assigned Admin Pool account) has Full Access permission on the target mailbox. If it doesn’t, MNE temporarily grants Full Access permission for the duration of the migration.

In the past, it has been observed that there can be a significant delay between granting Full Access permission and Office 365 actually allowing the account to access the mailbox. In MNE version 4.15.0, the PowerShell cmdlets Add-MNEMailboxAdminPermission and Remove-MNEMailboxAdminPermission were added which can be used to grant Full Access permission ahead of the migration (and revoke it after the migration). This is currently the recommended method of granting permission to the admin account for the migration. If using the PowerShell cmdlets to grant access, disable the built in mechanism by setting AddFullAccessPermission=0.

Type:

Default:

Occurs in:

 

keyword (single digit 0, 1 or 2)

0

Data Migr

 

Permits prepending an http scheme to migrated online meeting URLs. The parameter value is a single-digit keyword that specifies which string, if any, to prepend to the URL:

0: prepend nothing
1: prepend
http:// if there is no http or https scheme
2: prepend https:// if there is no http or https scheme

By default (AddOnlineMeetingUrlScheme=0), Migrator for Notes to Exchange prepends nothing to the URL.

Type:

Default:

Occurs in:

New in:

string

All Users

Data Migr

4.1.5

Specifies the name of the identity parameter for the UpdateAddressList cmdlet, which the wizard will run after mailbox-enabling a collection if UpdateAddressList=1 (also in this [Exchange] section). See the UpdateAddressList parameter description for more information.

Type:

Default:

Occurs in:

New in:

string

Default Policy

Data Migr

4.1.5

Specifies the name of the identity parameter for the UpdateEmailAddressPolicy PowerShell cmdlet, which the wizard runs when mailbox-enabling a collection if UpdateEmailAddressPolicy=1 (also in this [Exchange] section). See the UpdateEmailAddressPolicy parameter description for more information.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.15.1

In Notes and iNotes, when users set a task reminder to X days, hours, minutes before or after the task start date, the alarm notification is triggered X days, hours, minutes before or after 12:01 PM of the task start date.

When this parameter is set to the default value (1), after migration the alarm notification is triggered X days, hours, minutes before or after 12:00 AM instead of 12:01 PM.

To retain the Notes task alarm behavior and trigger the alarm before or after 12:01 PM, set this parameter to 0.

Type:

Default:

Occurs in:

New in:

integer

1001

Data Migr, for Office 365 migrations only

4.9

Associated with Migrator for Notes to Exchange’s Admin Account Pool features (see the chapter “Office 365 Admin Account Pool utility” in the Migrator for Notes to Exchange Administration Guide), this parameter specifies the number to assign to the first of a series of Admin Account Pool accounts grouped under the name specified by the AdminAcctPoolRoleGroupName parameter below.

Type:

Default:

Occurs in:

New in:

string

Notes Migrator Admins Role Group

Data Migr

4.9

Associated with MNE’s Admin Account Pool features (see the chapter “Office 365 Admin Account Pool utility” in the MNE Administration Guide), this parameter specifies the name of an Admin Role Group used to assign administration roles to the accounts in the Admin Account Pool. If the role group does not exist, the Office 365 Admin Account Pool utility creates the group and assigns the following roles to the group:

Type:

Default:

Occurs in:

 

string

[none]

NMM, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the Administrator user domain text box in the Exchange Server 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.

The parameter value documents the Windows domain required for the administrator's MAPI profile. This field is required for silent-mode operation. For example:

Type:

Default:

Occurs in:

 

string

[none]

NMM, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the Administrator SMTP address text box in the Exchange Server 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, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the Administrator password text box in the Exchange Server 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.

The parameter value documents the Windows password required for the administrator's MAPI profile. This field is required for silent-mode operation. For example:

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

Type:

Default:

Occurs in:

 

string

[none]

NMM, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the Administrator user name text box in the Exchange Server 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.

The parameter value documents the Windows username required for the administrator's MAPI profile. This field is required for silent-mode operation. For example:

AdminUsername=WilburBurns

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1 or 2)

0

Data Migr

4.14.1

This parameter works in conjunction with [ServerData]OOF which controls if out-of-office messages are migrated from Notes. By default, [ServerData]OOF is set to 0, meaning out-of-office messages are not migrated. When [ServerData]OOF=1, then [Exchange]AllowExternalOOF and its assigned value is applied.

Valid values are the following single-digit integers:

If the value is set to anything but 0, 1 or 2, then the setting defaults to 0.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.4.1

Determines whether HTML information in the Description field of calendar appointments and tasks will migrate. The default:

… tells the wizard to migrate such information. The feature can be disabled by AllowHTMLCalendarBodies=0.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.15.1

Determines whether or not the signer of the Exchange server certificate is verified against the list of trusted root certificate authorities. This setting is applied when performing calls to the Autodiscover service, and when connecting with MAPI using the Outlook Anywhere protocol. This setting can be useful when evaluating the product in a test lab where the Exchange servers have not been configured with properly signed certificates.

This parameter is only used when migrating with Outlook 2010 or 2013. It is ignored when migrating with Outlook 2016.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1 or 2)

[GUI entry]

Data Migr

4.1

This value corresponds to a GUI element in the Data Migration Wizard: the Overwrite existing mail forwarding address radio buttons in the Specify Exchange to Notes Mail Forwarding Settings screen. Quest recommends you do not manually enter or change this value except at the direction of Quest Support. The parameter value tells the wizard whether to set, update or remove mail forwarding, per the admin’s instructions in other program entries, even if the wizard detects an existing forwarding address or rule already in place for a particular user. Valid values are single-digit integer:

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 Remove existing forwarding address radio buttons in the Specify Remove Exchange Forwarding Settings screen. Quest recommends you do not manually enter or change this value except at the direction of Quest Support. The boolean parameter value tells the wizard whether it should refrain from removing an existing forwarding address or rule in Exchange if its domain does not match a ForwardingDomain parameter value (also in this [Exchange] section, and also derived from a GUI entry in the same screen):

Type:

Default:

Occurs in:

 

boolean

0

NMM, AD Grps, Prov, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the Always use these values checkbox in the Exchange Server Configuration screen. The value determines whether the wizards that need this information will always use the access credentials entered into the corresponding AD Configuration screen. For example, if:

... a wizard will skip the screen that requests this information, saving the admin the trouble of having to reenter the values and manually dismiss the screen. By default (AlwaysUseDefaults=0), the wizard will take the values entered in Notes Migration Manager as its defaults, but will display the screen to offer the option of accepting or changing the default credentials.

Type:

Default:

Occurs in:

 

boolean

0

Data Migr

 

Tells the wizard whether to automatically write the display names of Notes' email 2 and email 3 in the form Display Name (SMTP Address)— e.g., Joe Example (joeex@email.com). This feature, intended to make type-ahead easier to use, is off (0) by default, but can be enabled by:

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Tells the Data Migration Wizard whether to look up SMTP addresses in user archives in the Exchange GAL, to get Exchange addresses — e.g., so free-busy lookups will succeed. This feature is enabled by default, but can be disabled by setting the parameter to 0. For example, to migrate data to PST files without connecting to the Exchange server, set:

... and also, in the [General] section:

Type:

Default:

Occurs in:

New in:

keyword

kerberos

Data Migr, Prov

4.4

Determines an authentication mechanism for remote PowerShell calls by Migrator for Notes to Exchange applications. The default is kerberos, but you may specify another method by entering the name as the keyword parameter value (case-insensitive). The valid keyword values are:

basic
credssp

default
digest

kerberos
negotiate

negotiateWithImplicitCredential

These options are defined in this Microsoft link.

Type:

Default:

Occurs in:

New in:

boolean

Data Migr

4.15.1

When using the Autodiscover service to configure the MAPI profile (i.e. [Exchange] UseAutodiscoverCreateProfile=1), the protocol that the profile is configured to use is selected based on the results of an Autodiscover query performed when the profile is being created. The effect of this parameter depends on the version of Outlook installed on the MNE server:

Outlook 2010: MNE does not support the MAPI/HTTP protocol when migrating with Outlook 2010. The MAPI/HTTP protocol will never be selected when migrating to on-premise Exchange servers. MNE does not support migrating to O365 with Outlook 2010.
Outlook 2013: The AutodiscoverDisableMapiHttp parameter can be used to prevent the MAPI/HTTP protocol from being selected when the MAPI profile is being created.
Outlook 2016: The protocol used by Outlook 2016 is selected by MAPI when the MAPI connection is opened, however the protocol selected can be influenced through a registry setting (see the notes below).
NOTE: When migrating with Outlook 2013 or Outlook 2016, the registry value [HKEY_CURRENT_USER\Software\Microsoft\Exchange] MapiHttpDisabled is automatically modified by MNE to match the configuration provided by this parameter setting.

Type:

Default:

Occurs in:

New in:

boolean

Data Migr

4.15.1

When using the Autodiscover service to configure the MAPI profile (i.e. [Exchange] UseAutodiscoverCreateProfile=1), the Autodiscover endpoint must first be found. When migrating to an on-premises Exchange server, the correct Autodiscover endpoint can be quickly obtained by querying the appropriate Service Connection Point (SCP) object in AD. To bypass the SCP query and immediately fall back to using the domain portion of the admin user’s SMTP address to infer the Autodiscover endpoint, you can set this parameter to 0.

This parameter is only used if the parameter [Exchange] AutodiscoverUrl is not configured with a value.

This parameter is only used when migrating with Outlook 2010 or 2013. It is ignored when migrating with Outlook 2016.

Type:

Default:

Occurs in:

New in:

integer

10

Data Migr

4.15.1

Specifies the maximum number of HTTP redirects allowed when resolving the URL of the Autodiscover service. This parameter is ignored if the Autodiscover URL is specified with the [Exchange] AutodiscoverUrl parameter.

This parameter is only used when migrating with Outlook 2010 or 2013. It is ignored when migrating with Outlook 2016.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.15.1

The Autodiscover service may return two URL’s for connecting with RPC over HTTP; one for connecting from within the internal network, and another for connecting from the Internet. By default, MNE selects the internal URL when migrating to an on-premises target. This parameter can be used to override the default behavior. To override the default behavior, set AutodiscoverPreferInternalRpcHttpUrl=0.

This parameter has no impact when migrating to Office 365.

Type:

Default:

Occurs in:

New in:

string

Data Migr

4.15.1

MNE configures the temporary MAPI profiles that it creates using data obtained through the Exchange Autodiscover service. The URL of the service can be discovered dynamically, but this adds extra overhead to each Autodiscover query. Performance of these queries can be improved by providing the URL of the Autodiscover service through the AutodiscoverUrl parameter.

When migrating to O365, this setting is updated by the Migration Console when the Apply button is pressed on the Exchange Server page. The URL associated with the selected Office 365 Environment is chosen from the list of URL’s in the [MsOnlineAutodiscoverUrls] section.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1 or 2)

0

Data Migr

4.3

Specifies the method the wizard should use to process a recurring meeting series that contains more occurrences in Notes than the 999 maximum allowed by Exchange. Without this new control, attempts to migrate such meetings to Exchange 2010 would fail when the number of recurring instances exceeded the Exchange maximum. For example:

... tells the wizard to convert the item to a recurring series with no end date, which migrates cleanly.

The parameter value is a keyword that must be one of these single digits:

A migrated appointment will appear in Outlook with the same number of occurrences as in Notes, until the recurrence pattern is edited by the user, at which time it will assume the option set by this parameter.

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 Mailbox-enable ... accounts 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

0

Data Migr

 

Determines whether the wizard will delete the IPM.Configuration.Autocompletion message from the Inbox at the end of its data migration run. The AutoCompletion configuration message holds the cache of recently mailed-to users, but will cause errors in Outlook if the auto-completion lookup tables are corrupted—in which case Outlook will mistakenly tell users that valid addresses are invalid. The feature is off by default (DeleteAutocompleteMessages=0), but can be enabled by setting: DeleteAutocompleteMessages=1

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.7

This parameter and another (LocalExchangeFederationServer, also in this [Exchange] section) together support hybrid Office 365 migration (O365 provisioned by a local proprietary AD) with a local Exchange server and remote mailboxes (on O365) for some or most users. DirSyncEnableRemoteMailbox is a boolean parameter that, when enabled (1), tells the Data Migration Wizard to read the LocalExchangeFederationServer value to remote-mailbox-enable each principal provisioned during AD prep on the local Exchange. This feature therefore requires a valid FQDN value for LocalExchangeFederationServer, as described in that parameter entry below.

Note that this remote-mailbox-creation feature in preparing AD for AD sync does not support any settings associated with regular mailbox creation. For example, [Exchange] EmailAddressPolicyEnabled is not supported.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.15.1

When opening a MAPI connection, Outlook may present a dialog to request login credentials. MNE scans for this login dialog and when it finds it, automatically enters the Exchange Administration account credentials. In certain scenarios it may be useful to temporarily disable this mechanism (DisableCredentialScanner=1) to allow the user to manually enter the login credentials.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.15.1

When opening a MAPI connection, there are several dialogs that may be presented by Outlook in specific scenarios. MNE scans for these dialogs and attempts to handle them automatically. Some customers have experienced issues with this mechanism interfering with the Credential Scanner mechanism. If this happens, the Dialog Scanner mechanism can be disabled (DisableDialogScanner=1).

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 Remove mail Forwarding address checkbox in the Specify Remove Exchange Forwarding Settings screen. 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

[GUI entry]

Data Migr

4.1

This value corresponds to a GUI element in the Data Migration Wizard: the Set Mail Forwarding address checkbox in the Specify Exchange to Notes Mail Forwarding Settings screen. 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

[GUI entry]

Data Migr

4.1

This value corresponds to GUI elements in the Specify Mail Routing Options screen of the Data Migration Wizard: the Notes vs. Exchange radio buttons under All new mail ... will be delivered to. The Wizard automatically sets the values of this and three other related parameters (shown below) according to the admin’s radio-button choice, to tell the wizard which mail-routing screens to display in the current run. This DoShowRmvForwarding value in the [Exchange] section determines whether the wizard will (1) or will not (0) display its Specify Remove Exchange Forwarding Settings screen. The full set of related parameters, and how they are set:

If Notes destination is selected:

If Exchange destination is selected:

Quest recommends you do not manually enter or change these parameter values except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

[GUI entry]

Data Migr

4.1

This value corresponds to GUI elements in the Specify Mail Routing Options screen of the Data Migration Wizard: the Notes vs. Exchange radio buttons under All new mail ... will be delivered to. The Wizard automatically sets the values of this and three other related parameters (shown below) according to the admin’s radio-button choice, to tell the wizard which mail-routing screens to display in the current run. This DoShowSetForwarding value in the [Exchange] section determines whether the wizard will (1) or will not (0) display its Specify Exchange to Notes Mail Forwarding Settings screen. The full set of related parameters, and how they are set:

If Notes destination is selected:

If Exchange destination is selected:

Quest recommends you do not manually enter or change these values except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.4.2

Determines whether the wizard should, after mailbox-creation, set the newly created mailboxes to Automatically update e-mail addresses based on e-mail address policy. This is an Exchange feature offered in the Exchange Management Console, as a checkbox on the E-Mail Addresses tab of the Data Properties for each mailbox. This Migrator for Notes to Exchange parameter specifies whether the wizard should automatically enable or disable that Exchange feature during mailbox-creation. For example, the default:

… tells the wizard to enable the Exchange automatic-update feature (mark the Exchange checkbox). To disable the Exchange feature (unmark the Exchange checkbox), set EmailAddressPolicyEnabled=0. Note: When mailbox-enabling, make sure the setting for this EmailAddressPolicyEnabled parameter matches the setting for [ActiveDirectory] SetRecipPolicy.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.7

Determines whether the Data Migration Wizard will create mailbox archives in a hybrid Office 365 scenario (O365 provisioned by a local proprietary AD) when mailbox-enabling the remote mailboxes (on O365). The feature can be enabled by EnableRemoteMailboxArchive=1, but only if remote mailbox-enabling is also enabled for this scenario by DirSyncEnableRemoteMailbox (also in this [Exchange] section, described separately above).

Type:

Default:

Occurs in:

New in:

string

[null]

Data Migr

4.7

Enables or disables the feature to designate all migrating encrypted items as a particular Outlook category, which makes it possible to identify encrypted items in Outlook by a category search. The parameter value is a string that names the Outlook category. The feature is disabled by setting the parameter value to null or omitting the parameter altogether. The parameter is omitted by default.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.11

Enables or disables the option of extracting images from Notes messages and replacing them with OLE Device Independent Bitmap object attachments. This option makes images renderable in both OWA and the Office web client, and also improves image compression by a factor of two. The feature is enabled by default (1), or set ExtractEmbeddedImages=0 to disable it.

If the OLE Device Independent Bitmap uses significantly more storage than the original source image, you may be able to reduce the storage requirements by using the parameter MaxExtractedImageArea.

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

Type:

Default:

Occurs in:

New in:

string

[GUI entry]

Data Migr

4.1

This value corresponds to two GUI elements in the Data Migration Wizard: the Forwarding mail domain text box in the Specify Exchange to Notes Mail Forwarding Settings screen, and the Forwarding mail domain text box in the Specify Remove Exchange Forwarding Settings screen. Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

string

. [period character]

Data Migr

 

Specifies the character used to delimit the elements of Exchange-to-Notes forwarding addresses, when the Data Migration Wizard composes forwarding addresses. For example:

... tells the wizard to use a comma to delimit the elements of the forwarding address. By default, the wizard uses a period as the delimiter.

Type:

Default:

Occurs in:

New in:

keyword

TargetAddress

Data Migr

4.1

This value corresponds to a GUI element in the Data Migration Wizard: the Build address from drop-down list box in the Specify Exchange to Notes Mail Forwarding Settings screen. Quest recommends you do not manually enter or change this value except at the direction of Quest Support. The parameter specifies the method by which the Data Migration Wizard will compose forwarding addresses from Exchange to Notes. For example:

... specifies the SourceAddress method, as described below. By default the wizard will use the TargetAddress method, which also is the method used in pre-3.1 versions of the program. The three valid parameter values are:

TargetAddress (default): The left-hand side (LHS) of the TargetAddress column in the data table becomes the LHS of the forwarding address, to which the wizard appends the Forwarding Domain specified in the user interface during the program run.
SourceAddress: The SourceAddress column in the data table becomes the left-hand side (LHS) of the forwarding address, to which the wizard appends the Forwarding Domain specified in the user interface during the program run.
ForwardingAddress: The ForwardingAddress column in the data table becomes the forwarding address.

For the TargetAddress and SourceAddress options the delimiter character is usually a "dot" (period), but is configurable by the FwdAddrDelim parameter in this same [Exchange] section.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.7

Determines whether the Data Migration Wizard will add resource-owner permissions to resource delegates in Exchange who are migrating from Notes via the MigrateResourceDelegation parameter (also in this [Exchange] section, see below). This feature is off (0) by default. To add resource-owner permissions to migrating resource delegates, set GrantResourceOwnerFullAccess=1.

Note: This feature requires MigrateResourceDelegation=1, as described in that separate entry below. The Wizard will ignore this GrantResourceOwnerFullAccess parameter if MigrateResourceDelegation=0.

Type:

Default:

Occurs in:

 

boolean

[none]

NMM

 

This value corresponds to a GUI element in the Notes Migration Manager's Exchange Server Configuration screen: the Office 365 User domain drop-down list, used to specify the Office 365 domain that should be used to compose users’ Microsoft Online Services ID (logon names and email addresses). The program writes this value to the Task Parameters based on an admin's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support. The program loads this drop-down list with domains registered in Office 365 for the admin credentials entered elsewhere on the same screen. The Office 365 User domain specified here will be the portion of each user’s email address that follows the @ symbol. The left-hand-side of each user’s ID will be his/her User ID from Migrator for Notes to Exchange’s SQL database.

Type:

Default:

Occurs in:

New in:

string

[null]

Data Migr

4.7

This parameter and another (DirSyncEnableRemoteMailbox, also in this [Exchange] section) together support hybrid Office 365 migration (O365 provisioned by a local proprietary AD) with a local Exchange server and remote mailboxes (on O365) for some or most users. This LocalExchangeFederationServer value is a string for the FQDN of your local Exchange, which the program will need if DirSyncEnableRemoteMailbox=1 to remote-mailbox-enable each principal provisioned during AD prep on the local Exchange.

AD credentials are used for this feature because Migrator for Notes to Exchange does not ask for separate credentials for the local Exchange. The AD admin must therefore be a member of Organization Management to run EnableRemoteMailbox on the local Exchange.

Type:

Default:

Occurs in:

New in:

string

none

Data Migr

4.15.1

The name of an existing Outlook profile on the Migrator for Notes to Exchange admin migration computer that the Data Migration Wizard should use to access the migration target. You may use this setting when migrating to specify a specific profile to use, rather than dynamically creating a temporary profile to use for the migration. For example:

The quotation marks enclosing the profile name may be omitted if there is no space in the profile name.

IMPORTANT: The specified profile must be configured with the Use Cached Exchange Mode option disabled.
NOTE: This parameter is overridden by the [Exchange] UseAdminAcctPool parameter. When migrating with an account pool, each migration thread will dynamically create a temporary MAPI profile to be used by that migration thread.
NOTE: This parameter replaces the older [Exchange] RPCAdminMapiProfile parameter which has been deprecated. Additionally there is no longer any need to enable the profile through a separate parameter as was previously necessary using the [Exchange] RPCUseAdminMapiProfile parameter. It is sufficient to simply provide the name of the profile to be used.

Type:

Default:

Occurs in:

New in:

string

80040115,80040125

Data Migr

4.6

Specifies a comma delimited list of MAPI error codes for the MAPI Retry feature. MAPI Retry is a feature of MNE that attempts to recover from intermittent or brief network connectivity issues. The errors that are included in this list are errors that are typically returned from MAPI API functions when network connection issues do occur. If MNE encounters one of the MAPI errors listed in the MAPIErrorsToRetry setting, it will attempt to recover using the algorithm described below.

1
If a MAPI call fails with one of the errors listed in the MAPIErrorsToRetry list, the API call is made again after pausing for the number of seconds specified by MessageRetryWait. MNE keeps retrying for a maximum of MAPIRetryCount times.
3
If the attempt to open a new MAPI session fails, MNE waits for the number of second specified by MessageRetryWait and tries opening a new session again. MNE keeps trying to reconnect for a maximum of MaxSessionReconnectCount times.
6
MNE attempts to migrate each object using the algorithm above up to a maximum of MessageRetryCount times. If MNE reaches the MessageRetryCount limit, it assumes that there is something wrong with the object itself and it proceeds to the next object to be migrated.

The full list of parameters used to customize the MAPI Retry feature is below.

Type:

Default:

Occurs in:

New in:

integer

The value specified by the [Exchange] MessageRetryCount parameter

Data Migr

4.15.1.257

Determines the number of additional attempts that MNE will make to recover from a MAPI API function that fails with one of the errors listed in the MAPIErrorsToRetry parameter. If a MAPI retry error occurs, MNE waits for the amount of time specified by the MessageRetryWait parameter, and attempts to execute the MAPI API function again.

If the API function continues to fail and returns MAPI retry errors, once the MAPIRetryCount limit is reached MNE makes a new attempt to store the message using a new MAPI session, as described by the MessageRetryCount parameter.

If this parameter is not set, it defaults to the value that is specified by the MessageRetryCount parameter.

Type:

Default:

Occurs in:

New in:

boolean

Data Migr

4.15.1

This setting determines whether each migration worker thread shares a single dynamically created MAPI profile or, if separate MAPI profiles are created for each thread. This setting was added as a workaround to a MAPI bug that prevents the re-use of MAPI profiles when the MAPI over HTTP protocol is used. MAPI over HTTP is the only MAPI protocol available for use with Office 365 as of October 31, 2017. When migrating to Office 365, each migration worker thread will create its own temporary MAPI profile for its exclusive use.

By default, migrations to on-premises Exchange servers will continue to use the RPC over HTTP protocol with the MapiUseSharedProfile option enabled. This default value will be changed in the future once Microsoft has released an update to MAPI resolving the MAPI over HTTP issue.

This setting will be overridden by the following parameter settings:

[Exchange] UseAdminAcctPool: When the use of an Admin Account Pool is enabled, the use of a shared MAPI profile is disabled, regardless of the MapiUseSharedProfile setting.
[Exchange] MapiAdminProfile: If a manually created MAPI profile is specified, no dynamic MAPI profiles are created. The manually created profile is always be used.

Type:

Default:

Occurs in:

New in:

integer

200

Data Migr

4.15.1

Recurring-meeting messages from Notes with more than 255 attachments are divided into individual meetings in Exchange, according to the setting for this parameter. The value of this parameter represents the maximum number of attachments the wizard may encounter before creating a new meeting. The Wizard will create as many meetings as necessary to migrate the complete series with no more than the specified number of exceptions. For example:

… tells the wizard to create as many meetings as necessary to migrate the series with no more than 200 exceptions per message.

Type:

Default:

Occurs in:

New in:

integer

0

Data Migr

4.15.1.172

This setting is applied when [Exchange] ExtractEmbeddedImages is enabled.

During migration, images that are extracted from emails are converted into BMP images before being stored in Exchange as message attachments. Converting an image to BMP format can often result in an image whose data size is many times larger than the original image. Unfortunately, due to technical limitations of the RTF format, it is not possible to use other, more efficient image formats that support data compression.

To mitigate the impact to the target mailbox size of emails that contain large embedded images, the MaxExtractedImageArea setting can be used to specify the maximum allowable image area, in pixels, of the generated BMP image. During the conversion, if the limit would be exceeded, the embedded image is removed from the body of the email and it is replaced with the original image from the Notes source stored to the migrated message as a standard file attachment.

For example, to specify that all images lager than 640 x 480 (307200) pixels should be removed from the email body and migrated as file attachments, set MaxExtractedImageArea=307200.

By migrating the source image in its original format, the source image’s data compression can be retained with no loss in image quality. While the image will no longer be displayed in the actual body of the email in Outlook or OWA, it is still possible to open the images from the email client to view the content of the image.

When MaxExtractedImageArea=0, the image is migrated to Exchange with no size limit applied.

Type:

Default:

Occurs in:

Updated in:

integer

20

Data Migr

4.15.1.257

Determines the maximum number of times that MNE will attempt to reconnect the MAPI session if a message fails to migrate due to one of the errors that are specified by the MAPIErrorsToRetry parameter. MNE pauses between each reconnect attempt for the number of seconds specified by the MessageRetryWait parameter.

If MNE is unable to open a new MAPI session after MaxSessionReconnectCount attempts, the migration is aborted.

Type:

Default:

Occurs in:

Updated in:

integer

2

Data Migr

4.15.1.257

If a message fails to migrate due to one of the MAPI errors specified by the MAPIErrorsToRetry parameter, this parameter determines the maximum number of additional attempts that MNE will make to store the message. When MNE fails to store a migrated message to the target mailbox due to a MAPI retry error, MNE closes the existing MAPI session, opens a new session, and then attempts to store the message again.

If MNE is unable to open a new MAPI session, it continues to make additional attempts to connect with MAPI, as described by the MaxSessionReconnectCount parameter. MNE pauses between each reconnect attempt for the number of seconds specified by the MessageRetryWait parameter.

If MNE is able to successfully open new MAPI sessions, but attempts to store the message continue to fail and the MessageRetryCount limit is reached, MNE logs the MAPI error and the failure to migrate the current message. MNE then proceeds to the next message to be migrated.

Type:

Default:

Occurs in:

New in:

integer

30

Data Migr

4.6

Sets the delay (in seconds) between retry attempts for MAPI API functions that fail with one of the errors specified by the MAPIErrorsToRetry parameter, as documented by the MAPIRetryCount parameter.

The parameter also specifies the delay (in seconds) between MAPI session reconnect attempts, as documented by the MessageRetryCount parameter.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.6

Determines whether the Data Migration Wizard will migrate a Notes document that appears in the Trash view if it also appears in some other Notes view. By default:

... tells the wizard to skip such messages. The alternative (1) tells the wizard to always migrate Notes documents to their corresponding Exchange folders, even if they also appear in the Notes trash view.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.7

Determines whether the Data Migration Wizard will migrate the identities of mail-in database owners when it migrates mail-in DBs. The Directory Export Wizard captures these owner identities to Migrator for Notes to Exchange's SQL database in any case, but the migration of the identities to Exchange is an option that is enabled or disabled by this boolean program parameter.

By default (MigrateMailInDBOwner=1), the wizard will migrate the identities of mail-in DB owners. To disable this feature, set MigrateMailInDBOwner=0.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.13

Determines whether MNE will migrate the FYI attendees of a Notes meeting to the bcc field in Exchange, where they will appear as Resources, instead of to the cc field. This option keeps FYI attendees hidden if the organizer later changes the meeting, since Exchange sends notifications of such changes, and those notices would otherwise disclose the FYI attendees as Optional Attendees.

By default (MigrateMeetingFYIAsResource=1), MNE migrates FYI attendees of a Notes meeting to the bcc field in Exchange. You can disable the feature (0) to make MNE migrate FYI attendees to the cc field.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.7

Determines whether the Data Migration Wizard, when it migrates resources, will migrate their designated owners and authorized managers, and Notes' Owner Restrictions settings. The Directory Export Wizard captures this information in any case, but its migration to Exchange is an option that is enabled or disabled by this boolean program parameter.

This feature is off by default (MigrateResourceDelegation=0). To migrate the identities of resource owners and managers, and the associated resource-management access behaviors, set MigrateResourceDelegation=1.

What Notes calls a resource owner actually corresponds closely to what Exchange calls a delegate, and Migrator for Notes to Exchange migrates Notes' resource owners and behaviors on that basis. A table in the Migrator for Notes to Exchange Pre-Migration Planning Guide (in chapter 3, see Migrating Resources) shows how Notes' Owner Restrictions are mapped to resource behaviors in Exchange.

Another Migrator for Notes to Exchange parameter (also in this [Exchange] section, see GrantResourceOwnerFullAccess above) lets you also optionally add resource-owner permissions to migrated resource delegates in Exchange.

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.15.1

When migrating to Office 365, determines if MNE migrates Notes ACL rights to only the well-known Exchange folders Inbox, Calendar, Tasks, and Contacts.

IMPORTANT:  

This parameter is used only when targeting Office 365 and it does not change behavior related to folder ACL permission when targeting on-premises Exchange servers. When targeting an on-premises Exchange, both the Data Migration Wizard and the SSDM migrate ACLs for all folders involved.

When set to the default value (MigrateWellKnownFolderAclOnly=1), MNE migrates ACL rights to only the well-known folders Inbox, Calendar, Tasks, and Contacts.
When set to MigrateWellKnownFolderAclOnly=0, MNE performs folder ACL migration recursively to all folders that are involved in the migration.
NOTE:  

When set to (1), MNE always migrates the well-known folder permissions as long as Migrate mail data is checked.

When set to (0) and Specify Data to migrate has been set to not migrate Calendar or Tasks, then ACL permissions are not migrated to the Calendar or Tasks folder.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This value corresponds to a GUI element in the Data Migration Wizard: the Do not connect to an Exchange server checkbox in the Select Destination Exchange Server 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:

string

[none]

Data Migr

4.7

Specifies a single Office 365 account SKU that the Data Migration Wizard should use when licensing end users for O365. You can run the Get-MsolAccountSku cmdlet to retrieve the AccountSkuIds for all valid licenses.

The value of this setting is derived from the Product License field on the Select Office 365 Administrative Operations Quest screen in the Data Migration wizard. 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

Prov

4.8

Determines whether the Provisioning Wizard should preserve or overwrite the AD mail attribute (if any) when merging a CMN-created contact with an AD principal whose mail attribute is not empty.

For example: O365DirsyncPreserveADAttrMail=1 tells the wizard to preserve any existing AD mail attribute. By default (0), the attribute is overwritten.

Type:

Default:

Occurs in:

New in:

string

[none]

Data Migr

 

A coma separated list of license plan services that have been disabled.

The value of this setting is derived from the Product License field on the Select Office 365 Administrative Operations Quest screen in the Data Migration wizard. Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

keyword

AzureCloud

Data Migr

4.15.1

Identifies the O365 environment that is the target of the migration. By default MNE will migrate to the O365 Global Cloud, but this parameter can be used to select one of the available Microsoft National Clouds (e.g. Office 365 Germany). Currently the following values are supported for this parameter:

Type:

Default:

Occurs in:

New in:

string

https://outlook.office365.com/ews/exchange.asmx

Data Migr

4.15.1

Identifies the URL of the Office 365 tenant’s Exchange Web Services (EWS) endpoint. This setting is updated by the Migration Console when the Apply button is pressed on the Exchange Server page. The URL associated with the selected Office 365 Environment is chosen from the list of URL’s in the [MsOnlineEwsUrls] section.

Type:

Default:

Occurs in:

New in:

string

https://ps.outlook.com/powershell

Data Migr

4.15.1

Identifies the URL of the Office 365 tenant’s remote PowerShell endpoint. This setting is updated by the Migration Console when the Apply button is pressed on the Exchange Server page. The URL associated with the selected Office 365 Environment is chosen from the list of URL’s in the [MsOnlinePSConnectionUris] section.

Type:

Default:

Occurs in:

New in:

keyword

[none]

Data Migr

4.7

Specifies the Usage Location required by Microsoft for Office 365 licenses, per this Microsoft article. The Usage Location is a two-letter code for the country, as described in ISO 3166-1-alpha-2. Migrator for Notes to Exchange's Admin Account Pooling Utility requires a value for this parameter, and the value must conform to the standardized values listed for ISO 3166-1-alpha-2.

Type:

Default:

Occurs in:

 

string

[none]

Data Migr

 

Specifies a common output PST filename for all migrating users, when migrating data to PSTs. This value is used in conjunction with the PSTDir column in the SQL Server database, which specifies a unique PST directory for each user. The combination of a common PstFileName value with unique PSTDir values assures that the newly created PST files will be identifiable by user.

For example: PstFileName=migr-archive.pst combined with PSTDir column values set to \\server\home\user1, user2, user3, etc., would produce these new PST files in these locations:

Otherwise, if the PSTDir column is unspecified and the PstFileName parameter sets the output filename to a common value, the multiple files saved to the same directory would be differentiated only by appended digits: migr archive 1.pst, migr archive 2.pst, migr archive 3.pst, and so forth. Each user in a collection should therefore have a unique directory specified in the PSTDir column, such as the user's home directory on a server.

If PSTDir columns are specified but the PstFileName setting is left unspecified, then the [Outlook] PstFileNameFormat parameter is used to determine the PST filenames. If the PstFileNameFormat parameter is using the default setting (1), the new PST filenames are derived from users' display names.

Type:

Default:

Occurs in:

 

boolean

0

Data Migr

 

... tells the program to clear the contents of Personal Address Books in Exchange before migrating corresponding PABs from Notes—useful if, for example, you had already migrated PABs, but then wanted to migrate them again. The default PurgePABS=0 disables the feature, so no PABs are cleared. This feature clears only Exchange PABs that correspond to Notes PABs about to be migrated, and will not clear any other existing Exchange PABs.

Type:

Default:

Occurs in:

New in:

keyword (single digit 0, 1 or 2)

1

Data Migr

3.2

Tells the Data Migration Wizard which of three methods to use, to avoid creating duplicate items in Exchange when an item that has already been migrated to Exchange is queued to migrate again. For example:

... tells the wizard to delete the Exchange copy of the item and then remigrate it from Notes.

The parameter value is a single-digit integer, which must be one of these three valid values:

Type:

Default:

Occurs in:

New in:

string

[null]

Data Migr

4.7

When migrating to Office 365 and provisioning from a local AD via Microsoft's AD sync, this parameter sets the "right-hand side" of each user's remote routing address on the remote mailbox (the portion of the address that follows the "@" symbol) to the value specified here. The left-hand side of the address (preceding the "@" symbol) is the user's Alias. For example, if:

... then the routing addresses would be <Alias>@example.sitraka.com.

Note that this feature can be enabled only if remote mailbox-enabling is also enabled for this scenario by DirSyncEnableRemoteMailbox (also in this [Exchange] section, described separately above).

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.14.1

This parameter controls an Active Directory setting for provisioned groups. When set to the default value 1, the Exchange distribution group can accept messages from authenticated (internal) senders. Messages from unauthenticated (external) senders are rejected. When set to 0, all messages for the Exchange distribution group are accepted.

Type:

Default:

Occurs in:

 

boolean

[GUI entry]

Data Migr

 

This parameter corresponds to a GUI element in the Data Migration Wizard: the Reset Office 365 Passwords checkbox on the wizard's Operations screen. The checkbox and parameter value determine whether, when mailbox-enabling users in Office 365, the wizard will automatically generate random Office 365 passwords, assign them to users' Office 365 accounts, and save them locally so they can later be sent to users within Migrator for Notes to Exchange's You've Been Migrated mail-merge email. Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

integer

0

Data Migr

 

A single digit, 0–7, that specifies which (if any) of migrating mail, appointment and task items the wizard should pass through Microsoft’s rich-text converter—which in many cases will refine the exported compound document format from Notes’ own converter. The parameter value must be one of these digits:

0: None
1: Mail Only
2: Appts Only
3: Mail + Appts

4: Tasks Only
5: Mail + Tasks
6: Appts + Tasks
7: Mail + Appts + Tasks

Type:

Default:

Occurs in:

New in:

string

0

Data Migr

4.4.1

The name of an existing Outlook profile on the Migrator for Notes to Exchange admin migration computer that the Data Migration Wizard should use to access Office 365 (when migrating to Office 365). Use this setting, paired with the RPCUseAdminMapiProfile parameter (also documented separately below), when migrating to Office 365:

The quotation marks enclosing the profile name may be omitted if there is no space in the profile name. The Wizard will not read this parameter if the RPCUseAdminMapiProfile parameter is omitted or set to 0.

IMPORTANT: This parameter has been deprecated and replaced with the [Exchange] MapiAdminProfile parameter. If this parameter is specified, it will continue to work, but a warning will be logged to the migration log file.

Support for this parameter will be removed in a future version of MNE.

Type:

Default:

Occurs in:

New in:

string

[none]

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the Principal name for proxy server text box) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value specifies the Exchange proxy server certification server name (URL), when using the RPC protocol to communicate with the Exchange server. For example:

This parameter is required if RPCUseHTTP (see that parameter for more information about the RPC protocol). 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:

New in:

string

[none]

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the Use this URL to connect to my proxy server checkbox) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value specifies the proxy server name (URL), when using the RPC protocol to communicate with the Exchange server. For example: RPCProxyServerURL=ExampleURL

This parameter is required if RPCUseHTTP=1. See the RPCUseHTTP parameter for more information about the RPC protocol. 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:

New in:

boolean

0

Data Migr

4.4.1

Tells the wizard whether it should use an existing Outlook profile on the Migrator for Notes to Exchange admin migration computer, rather than automatically generate a temporary profile to use for the migration. When migrating to Office 365, you should set this parameter to 1, and specify a profile name with the RPCAdminMapiProfile parameter (also documented separately above):

The Wizard will not read the RPCAdminMapiProfile parameter if this RPCUseAdminMapiProfile parameter is omitted or set to 0.

IMPORTANT: This parameter has been deprecated. If this parameter is specified, it will continue to work when used with the RPCAdminMapiProfile parameter (also deprecated), but a warning will be logged to the migration log file.

Support for this parameter will be removed in a future version of MNE.

Type:

Default:

Occurs in:

New in:

keyword

1

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the Use this authentication… drop-down list box) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value specifies the authentication method the Data Migration Wizard should use when connecting to the Exchange proxy server, when using the RPC protocol to communicate with the Exchange server. For example:

... tells the wizard to use the NTLM method, while the default RPCUseAuthType=1 specifies the basic authentication method. See the RPCUseHTTP parameter for more information about the RPC protocol. 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:

New in:

boolean

0

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the On fast networks… checkbox) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value determines whether the Data Migration Wizard will, when using the RPC protocol to communicate with the Exchange server on a fast network, connect using HTTP first, and then connect using TCP/IP. For example:

... tells the wizard to enable this option, while the default (0) disables the option. See the RPCUseHTTP parameter for more information about the RPC protocol. 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:

New in:

boolean

0

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element, the Connect using Outlook Anywhere checkbox, in the Notes Migration Manager (Exchange Server Configuration screen) and Data Migration Manager (Select Destination Exchange Server screen). The boolean value determines whether the Data Migration Wizard will use Remote Procedure Calls (RPC) within HTTP packets to communicate with the target Exchange Server. For example:

... tells the wizard to use this RPC protocol, while the default (0) tells the wizard to use the default TCP protocol. The RPC protocol is required when migrating to Office 365, and is optional but may improve data throughput when migrating to an proprietary Exchange in a slower network. Note that the target Exchange server must also be configured for the RPC protocol to use it, by the other RPC… parameters in this [Exchange] section. (These other parameters are set by GUI elements in the Exchange Proxy Settings dialog box.)

The program writes this value to the Task Parameters from an admin's GUI entry in either screen; 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, Data Migr

4.1.4

This parameter corresponds to a GUI element (the Mutually authenticate the session when connecting with SSL checkbox) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value determines whether the Data Migration Wizard will mutually authenticate the session when using the RPC protocol to communicate with the Exchange server. For example:

... tells the wizard to enable this option, while the default (0) disables the option. See the RPCUseHTTP parameter for more information about the RPC protocol. 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:

New in:

boolean

0

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the On slow networks… checkbox) in the Exchange Proxy Settings dialog box in either the Notes Migration Manager or Data Migration Manager. The value determines whether the Data Migration Wizard will, when using the RPC protocol to communicate with the Exchange server on a slow network, connect using HTTP first, and then connect using TCP/IP. For example:

... tells the wizard to enable this option, while the default (0) disables the option. See the RPCUseHTTP parameter for more information about the RPC protocol. 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:

New in:

boolean

1

NMM, Data Migr

4.1.4

This parameter corresponds to a GUI element (the Connect using SSL only checkbox) in the Exchange Proxy Settings dialog box in the Notes Migration Manager or Data Migration Manager. The value determines whether the Data Migration Wizard will use a secure socket layer (SSL) to connect to the Exchange proxy server, when using the RPC protocol to communicate with Exchange. For example:

... tells the wizard to not use SSL, while the default (1) tells the wizard to use SSL. This parameter can be set to 0 only if the authentication method is set to NTLM by RPCUseAuthType=2 (see the RPCUseAuthType parameter above). See the RPCUseHTTP parameter for more information about the RPC protocol. 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, Data Migr

 

This value corresponds to a GUI element in the Notes Migration Manager: the mailbox Exchange Server for Mail Profile text box in the Exchange Server Configuration screen. The role of this configuration item is currently obsolete and is only used as a backup attribute for the Mailbox Server or Exchange CAS for Remote PowerShell, purely for backward compatibility purposes.

The feature is enabled/disabled, and the server name is set, by:

Server=<ServerName>

The value is written to the Task Parameters from an admin's GUI entry. As this value is set via a GUI element, Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

 

boolean

1

Data Migr

 

Tells the Data Migration Wizard whether to look up SMTP addresses in server mail in the Exchange GAL, to get Exchange addresses — e.g., so free-busy lookups will succeed. This feature is enabled by default, but can be disabled by setting the parameter to 0. For example, to migrate data to PST files without connecting to the Exchange server, set parameters as shown above for the ArchiveResolveAttendees parameter.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.12

Determines whether the Subject field for migrated meetings in resource calendars will be set to the actual Subject of the meeting, or to the organizer of the meeting (the person who booked the resource). By default (SetResourceMeetingSubjectToOrganizerName=0) the Subject field for migrated meetings in a resource's calendar is set to the actual Subject of the meeting, as in prior Migrator for Notes to Exchange releases. But setting the Subject field to the actual Subject of the meeting (by SetResourceMeetingSubjectToOrganizerName=1) mimics native Exchange/Outlook behavior.

Type:

Default:

Occurs in:

New in:

boolean

0

AD Grps

4.1.5

Determines whether the wizard will set the managedBy attribute to the DN of the owner in the user forest (1) or of the owner in the resource forest (0)—for environments configured for a resource and user forest. For example: SetManagedByToUserForest=1 tells the wizard to set managedBy to the DN of the owner in the user forest. The default (SetManagedByTo­UserForest=0) sets the managedBy attribute to the DN of the owner in the resource forest.

NOTE: Setting the managedBy attribute to the DN of the owner in the user forest requires a two-way trust between the two domains, which must be established before the wizard is run. The user/resource forest environment is intended to be a one-way trust, however, so that must be restored after the wizard has run. If the two-way trust is not established prior to running the wizard, the managedBy attribute will not be set correctly and the wizard will generate this error:

Type:

Default:

Occurs in:

New in:

boolean

1

Prov

4.6

Determines whether the Provisioning Wizard will enable Exchange's autoaccept feature upon provisioning of resources. The default SetResourceToAutoAccept=1 enables the feature. The alternative (0) leaves the feature disabled. Note that the resource autoaccept feature is available only for Exchange 2010 or Office 365.

Type:

Default:

Occurs in:

 

string

[null]

Prov

 

When provisioning users into local AD, and ProvisionUsers=1, this parameter tells the Provisioning Wizard to replace each user's mail domain with the specified parameter value. For example:

... tells the wizard that a user whose target address would otherwise be UserXYZ@sitraka.com should instead be provisioned into AD as UserXYZ@boofah.com. The default value is null (no substitution occurs).

Type:

Default:

Occurs in:

New in:

Updated in:

keyword

[GUI entry]

NMM, Data Migr

4.1

4.5

This value corresponds to a GUI element in the Notes Migration Manager: the Target Exchange server version field in the Exchange Server Configuration screen. Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

The parameter value specifies the migration destination, by one of these valid numeric keywords:

_2010
_2013
_2016

for Exchange 2010 or Office 365 (with or without the MS AD sync provisioning option).
for Exchange 2013.
for Exchange 2016.

Type:

Default:

Occurs in:

New in:

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

1

Data Migr

4.1

An auto-set parameter (see GUI-set and other “auto-set” parameters) that notes whether the Data Migration Wizard has detected CDOEXM, or PowerShell, or both, or neither, on the target (destination) Exchange server. The parameter value is a single-digit keyword representing one of four possible cases:

TargetTypeTested=0

TargetTypeTested=1

TargetTypeTested=2

TargetTypeTested=3

: No CDOEXM or PowerShell was found.

: CDOEXM was found.

: PowerShell was found.

: Both CDOEXM and PowerShell were found.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.1

… tells the Data Migration Wizard to run the Update-AddressList cmdlet after mailbox-enabling a collection, to complete the AD provisioning of recipients who are only partially provisioned. The Update-AddressList cmdlet will run with its identity parameter set to "All Users" by default, or to some other identity value if set by the AddressListName parameter (also in this [Exchange] section). This can be useful in migrations to Exchange 2010, when objects have been provisioned by tools such as Microsoft Identity Integration Server (MIIS) or custom provisioning tools that do not fully provision recipient objects. By default (0), the cmdlet will not run.

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.1

… tells the wizard to run the Update-EmailAddressPolicy cmdlet after mailbox-enabling a collection, to complete the AD provisioning of recipients who are only partially provisioned. The Update-EmailAddressPolicy cmdlet will run with its identity parameter set to Default Policy by default, or to some other identity value if set by the AddressPolicyName parameter (also in this [Exchange] section). This can be useful in migrations to Exchange 2010, when objects have been provisioned by tools such as Microsoft Identity Integration Server (MIIS) or custom provisioning tools that do not fully provision recipient objects. By default (0), the cmdlet will not run.

Type:

Default:

Occurs in:

New in:

string

[none]

Data Migr

4.15.1

When migrating to on-premises Exchange or Office 365 targets, MIME encoded HTML emails may not display correctly in the email client if there is a mismatch between the character encoding declared in the HEAD element of the HTML message and the character encoding declared in the MIME headers. When a mismatch occurs, the message displays as garbled text.

To correct this issue, enable the parameter by specifying the character set used by the HTML HEAD element that is causing a problem. For example:

UpdateHtmlWithMismatchedCharset=UTF-16

When the parameter is enabled, MNE checks for the character set in the HTML HEAD element and when found, the character set is replaced with the MIME header character set.

The parameter is disabled by default. Only enable the parameter if corrupted characters are observed in migrated messages.

UpdateHtmlWithMismatchedCharset=UTF-16

message 1

UTF-8

UTF-16 changed to UTF-8

message 2

UTF-8

US-ASCII (unchanged)

UpdateHtmlWithMismatchedCharset=US-ASCII

message 1

UTF-8

UTF-16 (unchanged)

message 2

UTF-8

US-ASCII changed to UTF-8

Type:

Default:

Occurs in:

New in:

boolean

[none]

Data Migr

4.13

MIME encoded HTML emails often have the charset encoding declared in two places. The first is within the MIME headers and the second is within the HEAD element of the HTML message itself. With properly formatted emails, these two charset declarations are identical. Some HTML emails have been found where the charset declaration in the MIME headers and the charset declaration in the HTML message do not match. Typically in these cases, the HTML charset declaration is not in the HEAD element where it is expected, but instead it appears later in the document, possibly in the BODY element. While these emails may not be technically valid, they are still handled properly by most email clients.

A new behavior has been observed in Office 365 where the Exchange server attempts to correct the discrepancy in the charset declarations by removing the HTML charset declaration that conflicts with the MIME header charset declaration, and inserting a new HTML charset declaration in the HEAD element that matches the charset of the MIME header. In these cases the charset declaration will no longer match the actual encoding of the HTML body and as a result, non-ASCII characters are corrupted in the rendering of the email message.

To correct this issue, enable the UpdateHtmlWithMissingCharset option. With this option enabled, MNE checks for the presence of a charset declaration in the HTML HEAD element during the migration process. If missing, NME inserts a charset declaration using the charset value from the MIME message header. While this charset declaration may not match the actual encoding of the message, it makes Office 365 think that everything is proper, and prevents Office 365 from removing the correct charset declaration that appears later in the document. The second charset declaration in the body overrides the newly inserted one that is declared in the HEAD element. As a result, the email message renders properly in the email client.

If any parsing errors occur during the parsing of the HTML, NME migrates the message with no modifications.

This option is off by default. This option adds some minimal overhead to the migration process. It should only be enabled if corrupted characters are observed in the migrated messages.

The issue has only been observed when migrating to Office 365, but it could potentially be introduced in a later update to on-premises Exchange.

Type:

Default:

Occurs in:

New in:

boolean

Grp Prov, Data Migr

4.15.1

Enables the Migrator for Notes to Exchange’s Admin Account Pool features (see the chapter “Office 365 Admin Account Pool utility” in the Migrator for Notes to Exchange Administration Guide).

Type:

Default:

Occurs in:

New in:

boolean

1

Data Migr

4.15.1

Specifies whether or not the Exchange Autodiscover service will be used to configure the MAPI profile created to connect to Exchange. When UseAutodiscoverCreateProfile is set to 0, the following parameters are used to manually configure the MAPI profile settings:

When UseAutodiscoverCreateProfile is set to 1, the parameters above are ignored and any MAPI profiles that are created by MNE are configured using Autodiscover. The parameters listed below can be used to customize the call to the Autodiscover service:

Note the following:

The UseAutodiscoverCreateProfile parameter is only configurable when migrating to an on-premises target with Outlook 2010 or 2013.

Type:

Default:

Occurs in:

New in:

boolean

1

NMM, Dir Exp

4.6

Determines whether Migrator for Notes to Exchange's Directory Export Wizard and Notes Migration Manager will update target addresses for the Office 365 domain (applies only when migrating to O65). When migrating to Office 365, the default UseO365Domain=1 tells the Directory Export Wizard to update target addresses with the new Office 365 domain. Also, if you change the target type to Office 365 (in Migrator for Notes to Exchange's Notes Migration Manager) and then Apply that change, the default UseO365Domain=1 tells Notes Migration Manager to regenerate the address translation table, to update target addresses with the new O365 domain. To not update target addresses with the O365 domain, disable this feature by setting UseO365Domain=0.

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

Type:

Default:

Occurs in:

New in:

boolean

0

Data Migr

4.12

Determines whether the scope of Migrator for Notes to Exchange’s Data Migration Wizard will be expanded to the entire forest (valid for Exchange 2010 or later), rather than limited to just the local domain. For example: ViewEntireForest=1 tells the wizard to expand its scope to include the entire forest. The feature is off (0) by default.

An expanded scope can be useful, for example, where Migrator for Notes to Exchange needs to run the set adserversettings ‑viewentireforest $true PowerShell cmdlet in a multi-domain forest, to enable other PowerShell commands for the same scope. (Note that the cmdlet must be run by Migrator for Notes to Exchange, not run independently.)

[Filter] section

Type:

Default:

Occurs in:

integer

20971520 for O365 target; otherwise [none]

Data Migr

This value corresponds to a GUI element in the Data Migration Wizard: the KB field in the Select Date and Size Filters screen, which specifies a size limit for attachments (only attachments that are smaller than the designated size will be migrated). The parameter value here is in bytes, although the value in the screen is entered in KB. (The default 20971520 bytes for an O365 target corresponds to a 20480 KB entry in the screen.) The Wizard writes this value to the Task Parameters from the 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:

date

[GUI entry]

Data Migr

4.5

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate only calendar data ... dated on or after field in the Select Date and Size Filters screen, which specifies the earliest items that the program will migrate (items that are timestamped on or after the designated date). 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:

date

NONE

Data Migr

4.5

This parameter specifies the earliest items that the program will migrate (items that are timestamped on or after the designated date). When set to NONE, all mail and calendar items are migrated.

Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

date

[GUI entry]

Data Migr

4.5

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate only messages ... dated on or after field in the Select Date and Size Filters screen, which specifies the earliest items that the program will migrate (items that are timestamped on or after the designated date). 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:

date

[GUI entry]

Data Migr

4.5

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate only calendar data ... dated on or before field in the Select Date and Size Filters screen, which specifies the latest items that the program will migrate (items that are timestamped on or before the designated date). 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:

date

NONE

Data Migr

4.5

This parameter specifies the latest items that the program will migrate (items that are timestamped on or before the designated date). When set to NONE, all mail and calendar items are migrated.

Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Type:

Default:

Occurs in:

New in:

date

[GUI entry]

Data Migr

4.5

This value corresponds to a GUI element in the Data Migration Wizard: the Migrate only messages ... dated on or before field in the Select Date and Size Filters screen, which specifies the latest items that the program will migrate (items that are timestamped on or before the designated date). 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.

[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].
관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택