MNE 4.16.2 AdministrationGuide
MNE 4.16.2 AdministrationGuide
2
Administration Guide
© 2022 Quest Software Inc.
ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a
software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the
applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written
permission of Quest Software Inc.
The information in this document is provided in connection with Quest Software products. No license, express or implied, by
estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest
Software products. EXCEPT AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE
AGREEMENT FOR THIS PRODUCT, QUEST SOFTWARE ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY
EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO
EVENT SHALL QUEST SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR
INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS IRUPTION
OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST
SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest Software makes no representations or
warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes
to specifications and product descriptions at any time without notice. Quest Software does not make any commitment to update
the information contained in this document.
If you have any questions regarding your potential use of this material, contact:
Quest Software Inc.
Attn: LEGAL Dept.
4 Polaris Way
Aliso Viejo, CA 92656
Refer to our website (www.quest.com) for regional and international office information.
Patents
Quest Software is proud of our advanced technology. Patents and pending patents may apply to this product. For the most current
information about applicable patents for this product, please visit our website at www.quest.com/legal.
Trademarks
Quest and the Quest logo are trademarks and registered trademarks of Quest Software Inc. in the U.S.A. and other countries. For
a complete list of Quest Software trademarks, please visit our website at www.quest.com/legal. Microsoft, Windows, Outlook and
Active Directory are registered trademarks of Microsoft Corporation in the United States and other countries. Office 365 is a
trademark of Microsoft Corporation in the United States and other countries. Domino is a registered trademark of international
Business Machines Corporation, registered in many jurisdictions worldwide. All other trademarks, servicemarks, registered
trademarks, and registered servicemarks are the property of their respective owners.
Legend
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.
IMPORTANT NOTE, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
Collection Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Wizard process screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Select Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Specify Collection Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Choose Member Selection Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Add Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Edit Collection Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Provisioning Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
How the wizard works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Before you run the Provisioning Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Wizard process screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Select Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Select User Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Customize Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Specify Active Directory Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Choose Your Method for Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Choose the Container for User Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Generating Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Configuration Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Creating Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Specify Task Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Task Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Task Completed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
About us . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Technical support resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
NOTE: Quest recommends that all administrators read the Quick-Start Guide and Pre-Migration
Planning Guide (in that order), and the first chapter of the Scenarios Guide. You can use that
information to prepare a detailed written Migration Plan before attempting the migration process.
When you are ready to begin the migration process, you can refer to the process instructions and notes
in the Scenarios Guide, and the operational details in the Administration Guide.
NOTE: Editing the Global Default Settings does not change any program configuration for previously
created tasks. Wizards retrieve Global Default Settings only as they create tasks, not when they run tasks.
Upgrade Templates
After a software upgrade to 4.16.1, the navigation drawer contains the Upgrade Templates option. Click to
upgrade all the full templates in the database to differential templates. A full template does not pick up new Global
Default settings after it is created. A differential template can pick up new Global Default settings.
If you do not upgrade all full templates in the database to differential templates during the MNE console start up,
you can still select Upgrade Templates from the MNE navigation drawer to upgrade them. After that, the Upgrade
Templates item is removed from the MNE navigation drawer.
Project view
This screen provides statistics that summarize the status of the various aspects and phases of the overall
migration project:
• Directory: The date and time of the last directory export and the number of users, groups, resources, and
contacts that were exported.
• Collections: The number of defined group and user collections that were defined by the program and
defined by the administrator. Also shows the total number of defined group collections and the number of
group collections that were provisioned into Active Directory.
• Group Provisioning Summary: The number of groups found in the Notes source and the number that
were provisioned in Active Directory.
• Migration summary: The number of users and resources that are ready for migration, numbers that have
been migrated, number that are active (migrating now), and number remaining to be migrated.
• Operation schedule summary: The number of tasks that have been scheduled for later runs: the total
number, the tasks still pending, and tasks currently running.
• License information: The usage data associated with the Quest license that authorizes the use of this
product.
View documentation
This screen lists the available PDF-format documentation and Release Notes associated with Migrator for Notes to
Exchange and provides buttons that let you View or Print the documents. To view PDF documents, you must
install the Adobe Reader software, available for free from: http://www.adobe.com/products/reader/
NOTE: The Exchange account must be a mailbox-enabled or, if migrating to Office 365, have a license that
includes an Exchange mailbox.
Alternately, you could grant the permissions manually using the following PowerShell cmdlet:
get-mailboxdatabase | add-adpermission -user <username> -extendedrights receive-as
However, if you grant permissions manually using PowerShell, you must reconfigure the account each time a new
database is added.
If you use the Automatically grant permissions option, MNE grants permissions on the database container and
the permissions are inherited by all databases, even the databases that are added after initial configuration. If you
are using the PowerShell cmdlet to grant access, disable the built-in mechanism by clearing the check box.
• If the Target Exchange server version is 2013, 2016, or 2019:
Exchange Mailbox Server: Name of the Exchange server, which has the Mailbox role installed on it and
will be the connection used for all Exchange PowerShell activities in the product.
• If the Target Exchange server version is 2010:
Exchange CAS Server: Name of the client-access (CAS) server, not an array. This is the connection used
for all Exchange PowerShell activities in the product.
NOTE: If migrating to a CAS, you must also set a throttling policy and WinRM, as described in
Appendix A (see How Do I Migrate to an Exchange Environment with a CAS Array?).
• Administrator SMTP address: The SMTP address of the administrator by whose authority the wizard will
perform its mail-related operations.
• Administrator domain\user or UPN: Enter the migration administrator login name for the Exchange mail
server (for the account associated with the Administrator SMTP address) in the following format:
domain\name or name@domain.sitraka.com.
• Administrator password: The password associated with the administrator account.
Always use these values:
Select this check box if you want the wizards to always use these credentials and settings.The wizards will
skip the screens that request credential information. If the check box is cleared, the wizards take the values
entered here as defaults, but displays the screens to offer the option of accepting or changing the entries.
More info:
Launches the Log Viewer to display the log file associated with this screen. This button is enabled only if
the program has encountered significant errors or warnings that warrant attention before continuing in the
migration process. If no such significant errors or warnings are encountered, the button appears grayed-out
(unavailable).
NOTE: When the target is Office 365, MNE checks to see if the Migration Account (or assigned Admin Pool
account) has Full Access permission on the target mailbox. If it does not, MNE temporarily grants Full
Access permission for the duration of the migration. This feature corresponds to the existing parameter
[Exchange] AddFullAccessPermission. However, the recommended method is to use the
PowerShell cmdlet to grant Full Access before migration (and clear the check box).
• Exchange Administrator: Enter the Office 365 account name for the migration administrator in the format
of name@domain.sitraka.com. The account must have the role of global administrator on the hosted
tenant.
• Administrator password: The password associated with the administrator account.
Tenant settings
• Office 365 Environment: Select the appropriate Office 365 environment in the list. The options are:
▪ Office 365 Global
▪ Office 365 Germany
▪ Office 365 operated by 21Vianet
• Office 365 User domain: In the drop-down list, select the Office 365 domain that should be used to
compose the user Microsoft Online Services ID (logon names and email addresses) in Office 365.
NOTE: The program loads the drop-down list with the domains registered in Office 365 for the
administrator credentials you entered. The Office 365 User domain selected is the portion of each
user email address that follows the @ symbol. The left side of each user ID is his/her User ID from
the MNE SQL server.
• Use Azure Active Directory Synchronization: Select this check box if you are using the Microsoft AD
synchronization tool to copy the contents of a local Active Directory to provision your Office 365 directory.
Leave this check box clear if you will provision Office 365 by any other method.
• Resolve attendees for [type] mail (two check boxes): Controls whether MNE looks up SMTP addresses
in the user server mail, and/or archives, in the Exchange GAL to get Exchange addresses—so that free-
busy lookups succeed. These options are disabled (cleared) by default. Leave the check box empty if you
want to migrate data to PST files without connecting to the Exchange server. Disabling the Resolve
attendees function can increase migration speed in some environments but can cause lost free/busy
information and introduce other issues in Outlook.
• Office 365 PowerShell Throttling: Click Configure to open a PowerShell Throttle Settings dialog box,
which calculates the maximum number of concurrent PowerShell connections each MNE server can open
(the MaxPowerShellConnections setting). MNE uses this value to enforce the limit set by Microsoft for the
tenant. The default for this throttle is 9 simultaneous runspace connections.
The dialog box calculates the MaxPowerShellConnections setting using the formula R / S, where R is the
number of simultaneous runspaces allowed by your tenant (Maximum Tenant Concurrency = 9 by default),
and S is the number of migration servers you will use. If the quotient is not a whole integer, MNE rounds
down to the next lower whole integer. The default value of MaxPowerShellConnections=0 is interpreted as
“no limit,” effectively turning off this limiting feature.
PowerShell Throttle Settings:
▪ Maximum Tenant Concurrency: The throttle set by Microsoft for your Office 365 tenant. The
default is 9.
▪ Maximum Migrations Servers: The maximum number of migration servers to be used for your
migration.
NOTE: Oversized attachments are defined using the maximum size limit for attachments that is set in the
Data Migration Wizard on the Select Date and Size Filters screen.
You have the option of automatically registering the MNE application with the Microsoft Azure portal using one-
click registration or you can chose to manually register the application.
App registration
• One-click registration: Click this button to automatically register the MNE application with the Microsoft
Azure portal. The Client ID, Client Secret, and Tenant fields are automatically populated. Once registration
is complete, you can click Save to store the settings in the MNE database and in the INI settings.
- OR -
• Follow instructions to manually register the App: You must perform the steps in Manually registering
the MNE application with the Microsoft Azure portal on page 22 to manually register Migrator for Notes to
Exchange with the Microsoft Azure portal site. It is important that you note the Application (client) ID and
client secret that is assigned since you must enter them, along with Office 365 Tenant name, in this page.
Register with Exchange admin user credential: Selected by default. Used if you want to register the MNE
application using the Exchange account that you entered as the Exchange administrator under Exchange
credentials. The specified account is used to connect to the Microsoft Azure portal and register the application.
Grant admin consent: Click this button to ensure the requested permissions needed to access the Microsoft
OneDrive stores and migrate attachments to the stores are granted to the application. When the Microsoft screen
NOTE: The Redirect URI is required to register the MNE application for both the Admin console and the
SSDM to be able to access mailbox OneDrive storage.
4 Click Register.
The newly registered application is displayed and the following application details become available.
▪ Application (client) ID: The Application ID created after the application is registered in the
Microsoft Azure portal. You must copy this ID and use it later to complete the App Registration.
IMPORTANT: You must enter fully qualified domain names (FQDN) for the Global Catalog host name
and the Domain Controller host name.
• Domain Controller host name Specify the Domain Controller that is used to read data from or write data
to Active Directory.
• User name and Password: The access credentials used to authenticate the administrator by whose
authority the program accesses Active Directory.
• Always use these values: Select this check box if the wizards will always use these credentials. If this box
is selected, the wizard skips the screen that requests credential information. If the check box is empty, the
wizard retrieves the values entered here as defaults, but will display the screen to offer the option of
accepting or changing the default credentials.
• Path to existing organizational unit for distribution groups: Fully qualified domain name (FQDN) for
the group organizational unit (OU) path.
• Path to existing organizational unit for creating external members for distribution groups: Fully
qualified domain name (FQDN) for the path for an existing organizational unit (OU) to which group
members will be assigned when a member must be created as a new AD contact (when there is no
corresponding AD user account).
• Create user objects in Active Directory: Determines whether the Provisioning Wizard will create a new
user object in AD when none is found to correspond with a user in the collection. Such new user objects are
created in the container specified by the Path to existing organizational unit for creating user objects
text box. Ordinarily the objects created are not mail-enabled, although the EnableUsers parameter (in Task
Parameters) can be set to 1 to change that default behavior.
• Path to existing organizational unit for creating user objects: Click Browse to find and specify the
relative domain name for an existing organizational unit (for example, cn=users) where any new user
objects will be created in AD (when a wizard encounters a contact for which there is no existing
corresponding AD user account).
• Use resource/user forest: If your target environment is configured for a resource forest and a user forest
with corresponding user accounts, you must provide these credentials for the Data Migration Wizard to
enable mailboxes and to associate the resource accounts with the user accounts. The credentials specified
here identify the user forest, while the credentials specified for AD credentials pertain to the resource
forest.
User forest credentials:
NOTE: In addition to specifying the User forest credentials here, you must also add a set of parameters to
the configuration data for the Data Migration Wizard, explained in Appendix A of the Migrator for Notes to
Exchange Administration Guide—see the topic How do I prepare the SQL database for mailbox-enabling (if
AD is configured for a resource forest and a user forest)?
NOTE: After editing data by this Export/Import feature, you may want to run the Notes Data Locator
Wizard to verify you have entered the data correctly (no typos or malformed notations), that the
necessary certifications are in place, and that Migrator for Notes to Exchange can access the NSFs.
NOTE: Each run of the Directory Export Wizard overwrites the current contents of Migrator for Notes
to Exchange’s SQL database (including any imported TSV values) with data newly exported from the
Domino Directory—except that you may choose whether the wizard should overwrite or keep any
DominoServerAddress values that have been changed by a TSV import. The wizard’s default is to
preserve any TSV-imported values, but a screen in the wizard lets you choose to overwrite them.
• Next Notes directory export: Displays the next scheduled run (if any) of a directory export task, as
configured by a previous run of the wizard or as amended on the Manage Scheduled Operations screen.
NOTE: Although you cannot edit an Auto-Defined collection, you can Copy an Auto-Defined collection to a
new name, and Edit the copy.
You can filter the contents of the Current group collections table to show only collections associated with a
particular label by specifying the label in the Show collections labeled as drop-down list.
NOTE: Labels are a device for classifying and sorting collections by alphanumeric strings that can be
assigned to collections in the Collection Wizard that creates them. Typically labels are defined to
characterize and group subsets of collections—for example, to sort collections by an organization’s
administrative divisions, you could define labels for Engineering, IS, Marketing, R&D, Sales, and so forth. Or
you could define labels for Atlanta, Chicago, Denver, Houston, Minneapolis, and so on to sort collections by
satellite office locations. Throughout Notes Migration Manager you can sort lists and tables of collections by
label, or specify a particular label to filter a list or table of collections to show only collections that are
assigned that label.
The Collection members table in the bottom half of the screen shows the members of whatever user collection is
currently selected in the table in the top half of the screen.
To view only the collections that are associated with a particular label
• Select the label from the Show collections labeled as drop-down list.
To copy an existing collection to a new collection under a new name (which you can edit)
• Select the collection in the Current group collections table, and click Copy.
To export all user-defined group collections in Migrator for Notes to Exchange’s SQL database
to a TSV file
NOTE: Note that this feature exports all group collections, not only the collections that are selected in the
table. This includes both auto-defined and user-defined group collections. Also, the export feature sends all
collections to a single TSV file, not to different files for different collections.
To import previously exported user-defined group collections from a TSV file into Migrator for
Notes to Exchange’s SQL database
1 Click Import Collections.
The feature opens an Import Group Collections dialog box (a standard Windows Open dialog box).
2 Use the dialog box to find and specify the TSV file that contains the collections you want to import.
3 Click Import.
The program imports the collections in the designated TSV file, and a progress bar reports the feature's
progress. If the feature encounters any errors or warnings, the dialog box displays an Error Log Report
option that you can click to open the log file to investigate.
4 When the feature has completed its run, click OK to dismiss the dialog box and return to the Manage Users
screen in Notes Migration Manager.
User Collections
• User Collections: Manage Users
• User Collections: Manage Design Classes
• User Collections: Send PAB Replicator
• User Collections: Locate Notes Data Stores
• User Collections: Provision Users
• User Collections: Migrate User Data
NOTE: Labels are a device for classifying and sorting collections by alphanumeric strings that can be
assigned to collections in the Collection Wizard. Typically labels are defined to group subsets of
collections—for example, to sort collections by administrative divisions, you could define labels for
Engineering, IS, Marketing, R&D, Sales, and so on. Or you could define labels for Atlanta, Chicago, Denver,
Houston, Minneapolis, and so on, to sort collections by geographic office locations. Throughout Notes
Migration Manager you can sort lists and tables of collections by label or specify a label to filter a list of
collections, to show only the collections that are assigned that label.
The Collection Wizard lets you define a New collection by selecting members from Active Directory, or by
importing members from a .tsv (tab-separated-values format) file, or both. You can also edit an existing collection
(but not an Auto-Defined collection), or copy an existing collection to a new name and edit the copy.
The Collection members table in the bottom of the screen shows the members of the user collection currently
selected in the table.
To view only the collections that are associated with a particular label
• Select the label from the Show collections labeled as drop-down list.
NOTE: This feature generates collections of users logically grouped by their Notes ACL and delegation data,
so that users with stronger work associations can be migrated together to minimize business disruptions
during the transition period.
NOTE: Depending on the size of your user "universe" and other factors in your local environment,
this process can take several minutes or longer. You can click Cancel to cancel the feature.
The suggested Smart Collections that appear in the list are hypothetical (not yet defined to MNE) until you
explicitly save them (in step 5).
2 Optional: Review the collection members. You can click on a collection in the left pane to view its members
in the right pane.
3 Optional: Redistribute members among the collections by adjusting the maximum number of members per
collection. By default, the generator sets the maximum size at whatever number of members permits
grouping without dividing ACL-related members across two collections. If you prefer a different per-
collection maximum, use the track bar (a horizontal slide control) below the collections table to try different
values until you are satisfied with the result. However, a smaller number will divide ACL-related members
across the break point between two collections.
4 Optional: To hide previously defined Smart Collections from the list in the Manage Users table, click the
check box: [X] Hide previously generated Smart Collections.
5 When the Smart Collections are defined, click Save to save them in MNE. When MNE posts its
confirmation note, click OK to return to the Manage Users screen.
NOTE:
• Once created and saved, Smart Collections can be edited or renamed the same as user-defined
collections.
• Smart Collection names are generated. If a collection already exists with the same name, MNE will
rename and hide the earlier collection (whether or not you select the Hide check box). No two
collections can have the same name.
• MNE applies the label “Smart Collection” to all Smart Collections so you can filter the collections table
(on the Manager Users screen) to show only Smart Collections.
• Smart Collections errors and debug info are logged in the migration console log.
The Collection Wizard lets you use the exported directory data (in the SQL database) to define the member
contents of user and group collections. A collection is a defined subset of the users or groups that were found and
exported from the Notes/Domino source. The provisioning, migration, and other features of MNE are applied to
collections of users and groups, and you use the Collection Wizard ito define these collections.
The names and definitions of column headings in the SQL database table are documented in chapter 4 (Directory
Export Wizard) of this Administration Guide (see Exported Data Elements in the SQL database).
Some of the columns in these data tables contain critical values that must not be edited, while others can be edited
as needed, and still others must be edited to implement certain strategic options or accomplish certain program
features.
NOTE: Each run of the Directory Export Wizard overwrites the current contents of Migrator for Notes to
Exchange’s SQL database (including any imported TSV values) with data newly exported from the Domino
Directory—except that you may choose whether the wizard should overwrite or keep any
DominoServerAddress values that have been changed by a TSV import. The wizard’s default is to preserve
TSV- imported DominoServerAddress values, but the Directory Export Wizard offers an option to overwrite
them.
NOTE: After editing data by these Export/Import features, you may want to run the Notes Data Locator
Wizard to verify that you have entered the data correctly (no typos or malformed notations), that the
necessary certifications are in place, and that Migrator for Notes to Exchange can access the NSFs.
NOTE: If the Notes Data Locator Wizard does not find users' NSF files, but you know their locations,
you can add the per-user NSF paths to the SQL database so the Data Migration Wizard can migrate
them. The procedure to edit the contents of a SQL Server data table is explained in Appendix A,
under How Do I Specify Per-User Locations for Notes Source Data? Within the data table, the
MailFilePath column defines the specific paths and NSF filenames to users' mail files. For example:
\\server\home\user\jdoe.nsf
\\server\home\user
• Next scheduled run for collection: Displays the next scheduled run (if any) of this task for the selected
collection, as configured by a previous run of the wizard or as amended on the Manage Scheduled
Operations screen.
NOTE: Statistics reported by Migrator for Notes to Exchange are based on uncompressed data sizes
provided by the Notes APIs. The APIs extract data in compressed form and provide the data to Migrator for
Notes to Exchange in an uncompressed state. Data volumes reported by Migrator for Notes to Exchange are
often higher than the values observed natively in Notes or transferred over the network to the migration
servers.
• Collections labeled as: A drop-down list that lets you filter the contents of the User collection list (below),
to show only collections associated with the particular label specified here. Labels are a device for
classifying and sorting collections. For more information, see the note under User Collections: Manage
Users.
• User collection: Use this drop-down list to specify the collection of users you want to migrate.
• Migrate: Launches the Migration Wizard for the designated user collection.
• Next scheduled run for collection: Displays the next scheduled run (if any) of this task for the selected
collection, as configured by a previous run of the wizard or as amended on the Manage Scheduled
Operations screen.
NOTE: Statistics reported by MNE are based on uncompressed data sizes provided by the Notes APIs. The
APIs extract data in compressed form and provide the data to <NE in an uncompressed state. Data volumes
reported by MNE are often higher than the values observed natively in Notes or transferred over the network
to the migration servers.
The wizard may perform the data-gathering task immediately following its configuration, or you can schedule the
task to run at a later time.
NOTE: This wizard can collect per-desktop statistics if the Post user logs to the central directory check
box is selected in the Shared Directories Configuration screen. If the check box is empty, the SSDM writes
its log files to the individual user local temp directories where the files are unavailable to the wizard.
• Statistics last gathered: Reports the date and time that per-desktop statistics were last gathered.
• Self-Service Desktop Migration statistics directory (UNC Path): The full path for the directory that
contains the central log file for the SSDM or click Browse to locate and specify a path. This is the same as
the directory for central log and status files that you entered in the Log Directory Configuration screen.
• Gather statistics: Launches the SSDM Statistics Collection Wizard.
• Next scheduled run for collection: Displays the next scheduled run of this task as configured by a
previous run or as amended on the Manage Scheduled Operations screen.
NOTE: This Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, as explained in chapter 13. The Task
Scheduler checks the SQL database to see whether any tasks are scheduled to run since the last check,
and runs any tasks it finds. See Using the Qsched.exe task-scheduling utility on page 116 for details on the
Task Scheduler.
Filter list:
• Operation type: Use this drop-down list to specify a task that you want to add to the Tasks table below.
Tasks in the Tasks table can be scheduled, edited, or run immediately, as explained below.
• Collections labeled as: A drop-down list that lets you filter the contents of the Collection name list to show
only collections associated with the specified label. Labels are a device for classifying and sorting
collections (see the note under User Collections: Manage Users).
• Collection name: Use this drop-down list to specify the collection to which you want.
Tasks table:
• Reschedule: Specify the date and time that you want the selected task to run. The task runs for all objects
in the collection even if some objects in the collection were processed in an earlier run of the task.
• Run now: Run the selected task immediately. The task will run for all objects in the collection, even if some
objects in the collection were processed in an earlier run of the task.
TIP: If the MNE Task Scheduler experiences logon failures when trying to start the service, see How do I
troubleshoot service startup permissions? in the How Do I ...? in Appendix A in this guide.
View Summaries
This screen lists an assortment of available statistics to help you plan for the migration and track its progress. Click
View summary to view a pop-up display of the associated information.
NOTE: Statistics reported by MNE are based on uncompressed data sizes provided by the Notes APIs. The
APIs extract data in compressed form and provide the data to MNE in an uncompressed state. Data volumes
reported by MNE are often higher than the values observed natively in Notes or transferred over the network
to the migration servers.
The first five summaries in the list provide pre-migration assessments of your existing Notes infrastructure. These
summaries derive their data from runs of the two Notes Discovery Wizards, followed by the Directory Export
Wizard, and the Notes Data Locator Wizard (for the All Users and Resources collection):
• User and resource details: A valuable information resource for migration planning, this summary lists all
resources and user mailboxes eligible for migration and reports the number of items and size of the data
store in Notes, identifying information such as department, location and server. Use this information to
define collections of resources and mailboxes to be migrated together. Typically, collections contain users
in the same department and location. The use of the data store size estimates permits you to create
collections of appropriate sizes so they can be completed in your intended time frame.
• Distribution list details: This summary shows the groups (distribution lists) defined in the Notes
environment, which MNE can migrate to Exchange. Information such as owner, group type, Notes and
Internet Address can help you collect similar groups together and have MNE provision them in the same
Organizational Unit (OU) in Active Directory. Many administrators prefer this approach instead of placing an
extremely large number of groups into the same OU container.
• Internet domains: Sometimes, usually in large Notes installations, an additional Internet domain is
configured on some servers. In cases such as mergers or acquisitions, the Notes infrastructure may
support some domains that are unknown to the staff performing the migration. This summary documents
View Logs
This screen launches the Log Viewer to view the program log file associated with a particular task run. You can
view the log of any task run by selecting it from the Task runs table and clicking View log file. You build the Task
runs table by defining the filters for its contents. In most cases, a combination of task type and the collection to
which the task was applied limits the run list to a manageable length.
Filter list:
• Operation type: Use this drop-down list to specify a task whose runs you want to add to the Task runs
table. You can filter the displayed list by collection.
Introduction
The NABs Discovery Wizard searches the Notes/Domino server to locate all Notes NABs (Name and Address
Books). The Directory Export Wizard and the Internet Domains Discovery Wizard extract critical directory
information from the NABs, which is read by the MNE provisioning and migration wizards so that they can perform
their tasks.
Field definitions and application notes for the wizard’s screens appear in the sections that follow.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable this capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
The Advanced Settings option is a toggle that determines whether the wizards will let you open and edit Task
Parameters. If the feature is enabled, this extra Customize Configuration screen will appear at the start of the
screen sequence for any Wizard that offers this feature.
Task Parameters are edited as if the parameters were stored in an INI file, although the parameters are stored as
part of the task definition within the SQL database. The Customize Configuration feature copies the current
parameter settings from the SQL database into a text document in Windows' Notepad, so you can use the
Notepad text-editing features to change parameter values or add new parameter specifications.
NOTE: Some parameters in different sections share the same keyname, so it is very important that
parameter values be entered and edited in the correct sections.
Generating Task
No information is entered into this screen.
This screen reports the wizard's progress as it determines the details and associated work items of the task you
have prepared it to create. You can review (in the next screen) the details and associated work items, and decide
whether to create the task, or go back and change specifications that define the task.
When this generation process is complete, the wizard displays the next screen.
Configuration Summary
This screen shows a summary of the task configuration you have specified, as defined by the Notes server
information and access credentials entered in previous screens.
Review this information to confirm that it describes the task you want to create. If you want to change anything,
click Back to return to earlier screens in this Wizard, to change values as necessary, or click Cancel to cancel the
wizard and return to the Find NABs screen in Notes Migration Manager. From earlier screens within this wizard,
you can click Next to return to this Configuration Summary screen.
Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and filename
for the text file.
Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the destination
printer.
Run: Creates the task as defined in the configuration summary, and immediately run the task. When you click
Run, the wizard displays a screen that reports its progress as it creates the task and a screen that reports its
progress as the task runs. When the task run is complete, the wizard displays a screen that reports the statistical
results of the task.
Creating Task
This screen reports the wizard progress as it creates the task defined on the Configuration Summary screen.
When the task-creation process is complete, the wizard clears this screen and runs the newly created task.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
This screen may also display an Error Log Report option if the program encountered any errors during its run. If
Error Log Report does appear, click it to view the program log and assess the severity of the errors. The Error
Log Report option launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and
resolve the errors.
When you are finished using the Error Log Report feature (or if the Error Log Report button does not appear),
click Exit to exit the wizard.
Introduction
The Internet Domains Discovery Wizard extracts all Internet domains it finds within the Notes NABs (Name and
Address Books) that were located by the NAB Discovery Wizard. These domains are used to generate address
aliases for all users, so that Exchange can recognize and correctly route mail sent to the users' old addresses.
Field definitions and application notes for the wizard’s screens appear in the sections that follow.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable the capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
The Advanced Settings option is a toggle that determines whether the wizards let you open and edit Task
Parameters. If the feature is enabled, the Customize Configuration screen is displayed at the start of the screen
sequence for any wizard that offers this feature.
Task Parameters are edited as if the parameters were stored in an INI file although the parameters are stored as
part of the task definition in the SQL database. The Customize Configuration feature copies the current parameter
settings from the SQL database into a text document in Windows Notepad, so you can use the Notepad text-
editing features to change parameter values or add new parameter specifications.
NOTE: Some parameters in different sections share the same keyname, so it is important that
parameter values be entered and edited in the correct sections.
Generating Task
No information is entered into this screen.
This screen reports the wizard progress as it determines the details and associated work items of the task you
prepared it to create. You can review (in the next screen) the details and associated work items, and decide
whether to create the task, or go back and change any specifications that define the task.
When this generation process is complete, the wizard displays the next screen.
Configuration Summary
This screen shows a summary of the task configuration you specified, as defined by the Notes server information
and access credentials entered in previous screens.
Review this information to confirm that it describes the task you want to create. To change anything, click Back to
return to previous screens, to change values as necessary, or click Cancel to end the wizard and return to the Find
NABs screen in Notes Migration Manager. In previous screens, you can click Next to return to this Configuration
Summary screen.
Save As: Lets you save the summary information to a text file. Follow the prompts to specify a path and filename
for the text file.
Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the destination
printer.
Run: Creates the task as defined in the configuration summary and run the task. When you click Run, the wizard
displays a screen that reports its progress as it creates the task and a screen that reports its progress as the task
runs. When the task run is complete, the wizard displays a screen that reports the statistical results of the task.
Creating Task
No information is entered into this screen. This screen reports the wizard's progress as it creates the task defined
on the Configuration Summary screen.
When the task-creation process is complete, the wizard clears this screen and runs the newly created task.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
This screen can also display an Error Log Report button if the program encountered errors during its run. If the
Error Log Report button appears, click it to view the program log and assess the severity of the errors. The Error
Log Report button launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and
resolve the errors.
When you are finished, click Exit.
Introduction
The Directory Export Wizard gathers user information from the Domino servers to create SQL Server data tables
that provide critical input data to the MNE provisioning and migration wizards. These wizards use this data to:
• Provision users and groups in Active Directory (AD).
• Merge Exchange contacts into corresponding AD accounts to create a single mail-enabled security object
per user.
• Convert Notes-format addresses in messages, address books, and contacts to the appropriate Internet
address for each user.
The Directory Export Wizard is run before the first run of any of the MNE provisioning or migration wizards.
Throughout the transition period, the Directory Export Wizard can be re-run as necessary to update the data files,
to accommodate any staff changes that are recorded in Domino during the transition.
You can configure the wizard to perform the export task immediately following configuration or you can schedule
the task to run at a later time.
A reference list of the wizard Exported data elements in the SQL database appears at the end of this chapter,
following the field definitions and application notes in the sections that follow.
NOTE: Some parameters in different sections share the same keyname, so it is very important that
parameter values be entered and edited in the correct sections.
Generating Task
This screen reports the wizard progress as it determines the process details and associated work items of the task
you have prepared it to create. You can review (in the next screen) the details and associated work items, and
decide whether to create the task, or go back and change any of the specifications that define the task.
When this generation process is complete, the wizard displays the next screen.
Configuration Summary
This screen shows a summary of the task configuration you specified, as defined by the Notes server information
and access credentials previously entered and the NABs and domains specified in the Notes Migration Manager.
Review the information to confirm that it describes the task you want to create. To make changes, click Back to
display the earlier screens and change the values, or click Cancel to cancel the wizard and display the Export
Notes Directory screen in Notes Migration Manager. From earlier screens in this wizard, you click Next to return to
this screen.
Two buttons offer the following options:
• Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and
filename for the text file.
• Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the
destination printer.
When you are satisfied that the displayed summary describes the task you want to create, click Next to create the
task.
The wizard displays a screen that reports its progress as it creates the task and clears the screen when the
process is complete.
Creating Task
This screen reports the wizard progress as it creates the task that you defined
When the task-creation process is complete, the wizard displays the Specify Task Schedule screen in which you
can schedule task runs for the newly created task.
The drop-down list at the top of the screen offers these scheduling options:
• Now on this computer: Runs the task when you click Next. The other scheduling controls on the screen
appear grayed out (unavailable) since they do not apply. Click Next to display the Task Progress screen.
• One or more times, as indicated below: The task will run one or more times, according to your
scheduling entries in this screen. If you select this option you must also specify where and when you want
the task to run.
• Manually: The task will not run or be scheduled at all. The other scheduling controls on the screen appear
grayed out (unavailable), since they do not apply. Click Next to display the Schedule Summary screen.
• Once: The task runs only once and not repeat. You can specify where to run and the start date and time.
Click Next to display the Schedule Summary screen.
These scheduling controls are enabled only if One or more times... is selected in the drop-down list:
• Where to run: Select either On any computer or On a specific computer. If you choose a specific
computer, you must also specify the machine name in the adjacent drop-down list.
• When to run:
▪ Start: Specify the calendar date for the first (or only) task run.
▪ Days of the Week: Specify one or more days of the week that you want the task to run. If you select
two or more days, the first task run will occur on the first selected day occurring on or after the
specified Start date.
▪ Between ____ and ____: Specify the beginning and ending times of a range of start times for the
task to run.
▪ Select one of these options for the end date:
▫ No end date: The task runs will adhere to this schedule until someone manually ends the
series by editing this schedule definition in Notes Migration Manager (in the Manage
Scheduled Operations screen).
▫ End after __ occurrences: The task runs will adhere to this schedule until the cumulative
number of runs matches the number specified here.
▫ End by: The task runs will adhere to this schedule until the calendar date specified here.
▪ [_] Start this task only after completing: [________________________]: Select this check box if
you want this new task to run only after some other previously defined Migrator for Notes to
Exchange task has run. If you select the check box, use the drop-down list to specify which
previously defined task must precede this one.
When you have set the task schedule in these scheduling controls, click Next to display the Schedule
Summary screen.
Schedule Summary
This screen appears only if you have selected One or more times... Once or Manually as your scheduling option
on the preceding Specify Task Schedule screen. The screen shows a summary of the task schedule you specified
in the Specify Task Schedule screen, or notes that the task will be run only Manually.
Review this information to confirm that it describes the schedule you want to define. If you want to change
anything, click Back to return to the Specify Task Schedule screen, to change the schedule specification, or click
Cancel to return to the Export Notes Directory screen in Notes Migration Manager. From the preceding screen
within this wizard, you can click Next to return to this Schedule Summary screen.
Task Progress
The screen reports the program's progress as it performs the defined task. When the process is complete, the
program displays its Task Completed screen to report the results.
Task Completed
The screen reports the results of the task run.
This screen may also offer an Error Log Report button if the program encountered errors during its run. If the
button does appear, click it to view the program log and assess the severity of the errors. The Error Log Report
button launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and resolve the
errors.
Other buttons can display that allow you to view .TSV files that are created to capture data for auto-resolved
addresses or for duplicate SMTP addresses that were skipped by the wizard.
When you are finished using the Error Log Report feature or viewing any .TSV files, (or if no buttons appear),
click Exit to exit.
NOTE: The Exchange admin credentials for the mailbox-enabling task must have sufficient rights to
create mailboxes on the Exchange server specified in this ExchangeMailboxStore column.
NOTE: The value in the ExchangeMailboxStore column is not immediately applied to users' AD
objects when the value is imported into the SQL database. The value is applied in AD only when the
corresponding mail-enabling task is performed.
• MailFilePath: The specific path and NSF filename to a user mail file, used when an administrator knows
the specific path and NSF file name for each user. If this MailFilePath column does not exist or is left empty,
the program will find the user's mail file by appending the MailFile column value to the path entered on the
Specify Notes Data Directory screen. Example:
\\server\home\user\jdoe.nsf
NOTE: The value in this SourceForwardingAddress column is not immediately applied to the users’
Active Directory objects when the value is imported into the SQL database. The value is applied in
AD only when the corresponding forwarding feature is invoked.
NOTE: The value in the TargetForwardingAddress column is not immediately applied to the users’
Active Directory objects when the value is imported into the SQL database. The value is applied in
AD only when the corresponding forwarding feature is invoked.
Introduction
The Collection Wizard lets you define the member contents of new user and group collections or change the
attributes of an existing collection. Migrator for Notes to Exchange provisioning, migration, and other features are
applied to collections of users and groups. You define these collections in the Collection Wizard. You can add
members to a collection by selecting objects from the SQL database or by importing the contents of a .tsv (tab-
separated-values format) file.
Select Collection
This screen appears only if you have started this wizard from outside Notes Migration Manager. The screen asks
you to specify an existing user collection whose definition you want to edit or to create a new User Collection.
If you launch this wizard from the Notes Migration Manager, click New collection to create a new collection or
select a collection in the drop-down list to edit and click Edit.
This screen contains one field with a drop-down list:
• Select an existing Collection or choose to create a new one: Use the drop-down list to select the
collection that you want, or to select Create a new User Collection.
Click Next.
Add Members
This screen lets you specify the search criteria for selecting objects from the SQL database to add members to this
collection. Regardless of how you define the addition of collection members from the database, the next screen
lets you (optionally) import additional members from a .tsv (tab-separated-values format) file.
The search criteria are defined with respect to one or more specified Attribute values. If you define multiple
criteria, they are applied in an AND fashion, as multiple filters (an object must satisfy all criteria to be included as a
member in the collection).
To clear the Search Results table (to start over adding members):
• Click Clear.
Introduction
The Groups Provisioning Wizard:
• Defines a task that provisions the distribution groups (create group objects) within Active Directory or Office
365 from a designated group collection (designated in the Provision Groups screen of Notes Migration
Manager from which this wizard is launched).
• Schedules the task to run at a particular time or at a series of recurring times.
Each run of the wizard is applied to a particular group collection that is designated by the Select collection to
provision drop-down list in the Provision Groups screen of Notes Migration Manager. Field definitions and
application notes for the wizard screens are described in the sections that follow.
Notes groups are typically provisioned all at once after all users have been migrated in the per-batch migration
process (see the Migrator for Notes to Exchange Scenarios Guide). Since the only data associated with a group is
its member list, the migration of a group consists only of it being provisioned into the target environment.
TIP: Group Membership Updating Privilege: The Groups Provisioning Wizard can provision groups so
that group managers who are not in Domain Admins can still update group membership. This privilege
corresponds to a check box in Active Directory, the Manager can update membership list check box in the
Managed By tab of AD Group Properties.
The feature is enabled/disabled in Migrator for Notes to Exchange through a boolean parameter in the
[ActiveDirectory] section of MNE Global Defaults or Task Parameters. The parameter is enabled by default:
[ActiveDirectory] GroupManagerCanUpdateMembershipList=1
However, you can set GroupManagerCanUpdateMembershipList=0 to tell MNE not to extend the updating
privilege to group managers who are not Domain Admins.
Screen-by-screen field notes and application notes for the Wizard process screens are described in the following
sections.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager.
NOTE: Some parameters in different sections share the same keyname, so it is important that
parameter values be entered and edited in the correct sections.
NOTE: If you have multiple Global Catalogs/Domain Controllers in an AD forest, you can choose any
GC in the setup as long as it is in the same domain.
IMPORTANT: If migrating to an Exchange on-premises server, you must enter fully qualified domain
names for the Global Catalog host name and Domain Controller host name.
• Domain Controller host name: Specify the PowerShell Domain Controller that Migrator for Notes to
Exchange will call to perform operations in Exchange 2010 or later.
• User name: The sAMAccountName, UPN, or fully qualified DN of the administrator by whose authority the
wizard will access the target AD. If your sAMAccountNames are ambiguous, use the UPN or DN.
• Password: Password associated with the User name.
Click Next.
Generating Task
The screen reports progress as it determines the details and associated work items of the task you configured. In
the next screen you can review the details and associated work items, and decide whether to create the task, or go
back and change any specifications that define the task. When the process is complete, the wizard displays the
next screen.
Configuration Summary
This screen shows a summary of the task configuration you have specified.
Review this information to confirm that it describes the task you want to create. To change anything, click Back to
return to earlier screens and change values as necessary, or click Cancel to return to the Provision Groups screen
in Notes Migration Manager. From earlier screens within this wizard, you can click Next to return to this
Configuration Summary screen.
Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and filename
for the text file.
Print: Prints a paper copy of this summary information. Follow the prompts to specify the destination printer.
Run: Creates the task as defined in the configuration summary and run the task. When you click Run, the wizard
displays a screen that reports its progress as it creates the task, and a screen that reports its progress as the task
runs. When the task run is complete, the wizard displays a screen that reports the statistical results of the task.
Creating Task
No information is entered into this screen. This screen reports the wizard's progress as it creates the task defined
on the preceding Configuration Summary screen.
When the task-creation process is complete, the wizard clears this screen and runs the newly created task.
NOTE: The Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, as explained in chapter 13 of the Migrator
for Notes to Exchange Administration Guide. The Task Scheduler checks the SQL database to see whether
any tasks have been scheduled to run since the last check, and runs any tasks it finds. See chapter 13 for
details on the Task Scheduler.
The drop-down list at the top of the screen offers the following scheduling options:
• Now on this computer: The wizard runs the task when you click Next. The other scheduling controls on
the screen appear grayed out (unavailable), since they do not apply. Click Next to display the Task
Progress screen.
Schedule Summary
This screen appears only if you have selected One or more times... or Manually as the scheduling option on the
Specify Task Schedule screen. The screen shows a summary of the task schedule you specified in the Specify
Task Schedule screen or notes that the task will be run Manually.
Review this information to confirm that it describes the schedule you want to define. To change anything, click
Back to return to the Specify Task Schedule screen, or click Cancel to cancel this wizard and return to the Export
Notes Directory screen in Notes Migration Manager. From the preceding screen, you can click Next to return to
this Schedule Summary screen.
When you are satisfied that the displayed summary describes the task schedule you want to create, click Finish to
dismiss this screen:
• Finish: Clears this Schedule Summary screen, to return to the Export Notes Directory screen in Notes
Migration Manager.
The remaining screens documented for this Wizard are skipped if you have selected One or more times... or
Manually as your scheduling option on the preceding Specify Task Schedule screen.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
f the program encountered errors during its run, the Task Completed screen displays an Error Log Report button.
Click the button to view the program log and assess the severity of the errors. The Error Log Report button
launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and resolve the errors.
When you are finished, click Exit to exit the wizard.
Introduction
Notes data stores contain the data associated with Notes features: emails, PABs, archives, calendar data, and so
on. (Generically, a data store is any repository of data.) Some Notes data stores reside in central locations where
they are available to all users. Other data stores reside on user local workstations, each containing only the
information associated with the individual user. Migrator for Notes to Exchange can migrate data from anywhere
within the Notes system but only if it knows where the various data stores reside.
Migrator for Notes to Exchange includes a Notes Data Locator Wizard that scans the Notes environment for all
data stores associated with a designated user collection. The wizard records (in the MNE SQL database) the
locations of all data stores it finds together with associated statistics. The wizard displays the information in a table
in the MNE Notes Migration Manager, on the Locate Notes Data Stores screen under User Collections. Statistics
include information such as the size of the store, number of items in the store, average per-item size of items in the
store, date and time the statistics were last collected or updated.
Using the Notes Data Locator Wizard, you define a task to locate data files in the Notes source for a specific user
collection or gather statistics from previously located data files. You can schedule the task to run at a particular
time or at a series of recurring times. You can configure the wizard to locate data files by type (mail vs. PABs vs.
archives) in any combination.
The Notes Data Locator Wizard is launched from the Locate Notes Data Stores screen of Notes Migration
Manager, and is always applied to the user collection specified in the Locate Notes Data Stores screen. Field
definitions and application notes for the wizard screens appear in the sections that follow.
NOTE: Since the PAB Replicator is designed to copy the user local data stores to a centralized location,
ensure that all users have run the PAB Replicator before you run the Notes Data Locator Wizard.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable this capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
NOTE: Some parameters in different sections share the same keyname, so it is important that
parameter values be entered and edited in the correct sections.
NOTE: If the Notes Data Locator Wizard finds a PAB twice, once by the server and again by the file
system, the Data Migration Wizard tries to migrate it twice. But the file-system attempt will fail and
generate an error because the successful server access locks the file, rendering it inaccessible.
While the radio buttons make it impossible to locate by both methods at once, it is possible to run the
wizard more than once, and to select different location methods in different runs of the wizard.
NOTE: PAB data will be duplicated in Exchange if you remigrate to the server and use a different
method (server vs. file system) than the first migration.
A third option is shown only if at least one user has an entry in the SQL database for PABPaths or SharedPABDirs:
• Use PABPaths and/or SharedPABDirs from database (m of n populated): Looks for the user PABs in
the locations specified per-user in the PABPaths or SharedPABDirs column of the SQL database. The “m
of n populated” reports the number of users in the collection who have a PABPaths or SharedPABDirs entry
(m) out of the total number of users in the collection (n).
Click Next.
NOTE: If the Notes Data Locator Wizard finds an Archive twice, once by the server and again by the
file system, the Data Migration Wizard will try to migrate it twice. But the file-system attempt will fail
and generate an error because the successful server access will have locked the file, rendering it
inaccessible. While the radio buttons in this screen make it impossible to locate by both methods at
once, it is possible to run the wizard more than once, and to select different location methods in
different runs of the wizard.
NOTE: Archive data will be duplicated in Exchange if you remigrate to the server and use a different
method (server vs. file system) than the first migration.
A third option is shown only if at least one user has an entry for ArchivePaths or SharedArchiveDirs in the SQL
database:
• Use ArchivePaths and/or SharedArchiveDirs from database (m of n populated): Looks for users'
archives in the locations specified per-user in the ArchivePaths or SharedArchiveDirs column of the SQL
database. The “m of n populated” reports the number of users who have an ArchivePaths or
SharedArchiveDirs value (m) out of the total number of users in the collection (n).
Click Next.
To return to the previous screen and copy the Selected Users list into the “ignore list” on the
previous screen:
• Click OK.
When the Selected Users “ignore” list appears as you want it, click OK to save the list and return to the Specify
How to Determine Owner Using ACL screen.
Generating Task
This screen reports the wizard's progress as it determines the details and associated work items of the task you
have configured. You can review (in the next screen) the details and associated work items, and decide whether to
create the task or go back and change any specifications that define the task.
When this generation process is complete, the wizard displays the next screen.
Configuration Summary
This screen shows a summary of the task configuration you have specified.
Review the information to confirm that it describes the task you want to create. To change anything, click Back to
return to earlier screens in the wizard and change values, or click Cancel to cancel the wizard and return to the
Locate Notes Data Stores screen in Notes Migration Manager. From earlier screens within this wizard, you can
click Next to display this screen.
Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and filename
for the text file.
Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the destination
printer.
Run: Creates the task as defined in the configuration summary and immediately runs the task. When you click
Run, the wizard displays a screen that reports its progress as it creates the task and displays a screen that reports
progress as the task runs. When the task run is complete, the wizard displays a screen that reports the statistical
results of the task.
Creating Task
This screen reports the wizard's progress as it creates the task defined on the Configuration Summary screen.
NOTE: The Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, explained in chapter 13 of the Migrator for
Notes to Exchange Administration Guide. The Task Scheduler checks the SQL database to see whether any
tasks have been scheduled to run since the last check, and runs any tasks it finds.
The drop-down list at the top of the screen offers the following scheduling options:
• Now on this computer: Runs the task as soon as you click Next. The other scheduling controls on the
screen appear grayed out (unavailable) since they do not apply. Click Next to display the Task Progress
screen.
• One or more times, as indicated below: The task runs one or more times, according to the entries in the
scheduling controls. If you select this option you must specify where and when you want the task to run.
• Manually: The task will not run or be scheduled at all. The other scheduling controls on the screen appear
grayed out (unavailable) since they do not apply. Click Next to display the Schedule Summary screen.
• Once: The task runs only once and does not repeat. You can specify where to run and the start date and
time.
These scheduling controls are enabled if One or more times... is selected in the drop-down list:
• Where to run: Select either On any computer or On a specific computer. If you choose a specific
computer, you must specify the computer name in the adjacent text box.
• When to run:
▪ Start: Specify the calendar date for the first (or only) task run.
▪ Days of the Week: Specify one or more days of the week on which you want the task to run. If you
select two or more days, the first task run occurs on the first selected day on or after the specified
Start date.
▪ Between [____] and [____]: Specify the beginning and ending times of a range of start times for
the task to run.
▪ Select one of these options for the end date:
▫ No end date: The task runs adhere to this schedule until you manually end the series by
editing the schedule definition in Notes Migration Manager (in the Manage Scheduled
Operations screen).
▫ End after __ occurrences: The task runs will adhere to this schedule until the cumulative
number of runs matches the number specified here.
▫ End by: The task runs adhere to this schedule until this date.
▪ [_] Start this task only after completing: [________________________]: Select this check box if
you want this new task to run only after some other previously defined Migrator for Notes to
Exchange task has run. If you select the check box, use the drop-down list to specify which
previously defined Migrator for Notes to Exchange task must precede this one.
When you have set the task schedule, click Next to display the Task Progress and Schedule Summary screens.
Task Progress
The screen reports the program's progress as it performs the defined task.
You may click Cancel to cancel the task before it completes.
Task Completed
The screen reports the results of the task run.
This screen can also display an Error Log Report button if the program encountered errors during its run. If the
Error Log Report button appears, click the button to view the program log and assess the severity of the errors.
The Error Log Report button launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you
interpret and resolve the errors.
When you are finished, click Exit.
Introduction
The most common method for provisioning Active Directory begins with a directory update using the Quest
Coexistence Manager for Notes (CMN) Directory Connector. The CMN tool can extract data from the
Notes/Domino source and create mail-enabled security objects or contacts in Active Directory for all Notes users.
If the migrating users are already using AD security objects for network authentication, the directory update should
have been configured to create new AD contacts which now correspond to the existing user objects in AD. In this
case, The Provisioning Wizard can consolidate such duplicates before any data is migrated.
The Provisioning Wizard is run only once per user collection and must be run before the Data Migration Wizard is
run for those users. The user collection is specified in the Notes Migration Manager screen (see User Collections:
Provision Users).
Field definitions and application notes for the wizard screens appear in the sections that follow (under Wizard
process screens).
cn altRecipient extensionAttribute8
mail legacyExchangeDN extensionAttribute9
mailNickname extensionAttribute1 extensionAttribute10
proxyAddresses extensionAttribute2 extensionAttribute11
sAMAcountName extensionAttribute3 extensionAttribute12
userPrincipalName extensionAttribute4 extensionAttribute13
targetAddress extensionAttribute5 extensionAttribute14
employeeNumber extensionAttribute6 extensionAttribute15
distinguishedName extensionAttribute7
If the attribute you want does not appear in this list, you must add it as described in Appendix A: see How Do I Add
to the List of AD Attributes Available for the Merge Function?
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable this capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
The Advanced Settings option is a toggle that determines whether the wizards will let you open and edit Task
Parameters. If the feature is enabled, this extra Customize Configuration screen will appear at the start of the
screen sequence for any Wizard that offers this feature.
Task Parameters are edited as if the parameters were stored in an INI file, although the parameters are stored as
part of the task definition within the SQL database. The Customize Configuration feature copies the current
parameter settings from the SQL database into a text document in Windows' Notepad, so you can use the
Notepad text-editing features to change parameter values or add new parameter specifications.
NOTE: Some parameters in different sections share the same keyname, so it is very important that
parameter values be entered and edited in the correct sections.
NOTE: If you have multiple Global Catalogs/Domain Controllers in an AD forest, you may choose any
GC in the setup as long as it is in the same domain.
• Domain Controller host name: Specify the PowerShell Domain Controller that Migrator for Notes to
Exchange will call to perform operations in Exchange.
• User name: The user name of the administrator by whose authority the program will access the Active
Directory.
• Password: The password associated with the user name.
Click Next.
IMPORTANT: The AD Object Wizard generates an error if the database column you specify is not
populated with data
• Specify the Active Directory Attribute that matches: Specify the AD attribute whose values (for mail-
enabled objects) will match the values in the corresponding column for associated contacts in the SQL
database.
Generating Task
No information is entered into this screen.
This screen reports progress as the wizard determines the details and associated work items for the task. You can
review (in the next screen) the details and associated work items, and decide whether to create the task, or go
back and change any specifications that define the task.
When this generation process is complete, the wizard displays the next screen.
Creating Task
No information is entered into this screen. This screen reports progress as the wizard creates the task defined on
the preceding Configuration Summary screen.
When the task-creation process is complete, the wizard clears this screen and runs the newly created task.
NOTE: The Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, as explained in chapter 13 of the Migrator
for Notes to Exchange Administration Guide. The Task Scheduler checks the SQL database to see whether
any tasks have been scheduled to run since the last check, and runs any such tasks it finds. See chapter 13
for more information about the Task Scheduler.
The drop-down list at the top of the screen offers these scheduling options:
• Now on this computer: The wizard runs the task as soon as you click Next. The other scheduling controls
on the screen appear grayed out (unavailable), since they do not apply. Click Next to display the Task
Progress screen.
• One or more times, as indicated below: The task runs one or more times, according to your entries in the
scheduling controls. If you select this option you must specify where and when you want the task to run in
the scheduling controls.
• Manually: The task will not run or be scheduled at all. The other scheduling controls on the screen appear
grayed out (unavailable), since they do not apply. Click Next to display the Schedule Summary screen.
• Once: The task runs only once and will not repeat. You can specify where to run and the start date and
time.
These scheduling controls are enabled only if One or more times... is selected in the drop-down list:
• Where to run: Select either On any computer or On a specific computer. If you choose a specific
computer, you must also specify the machine name in the adjacent text box.
• When to run:
▪ Start: Specify the calendar date for the first (or only) task run.
Task Progress
No information is entered into this screen. The screen reports the program's progress as it performs the defined
task. You can click Cancel to cancel the task before it completes.
When the process is complete, the program displays its Task Completed screen to report the results.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
This screen can display an Error Log Report button if the program encountered errors during its run. If the Error
Log Report button appears, click it to view the program log and assess the severity of the errors. The Error Log
Report button launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and resolve
the errors.
When you are finished, click Exit.
Introduction
The Send PAB Replicator Wizard sends a special email form to Notes users in a particular user collection that lets
them copy all their PABs (personal address books) to a centralized Notes server directory, where the Data
Migration Wizard can find and migrate them.
The PAB Replicator Wizard is applied to a particular user collection, designated in the Send PAB Replicator screen
of Notes Migration Manager, from which this wizard is launched. Field definitions and application notes for the
wizard’s screens are provided in the sections that follow.
NOTE: The email form that this feature sends to users contains a button icon that users can click to start the
replication function. An iNotes client, however, renders the message as plain text, so the button does not
appear for iNotes users. The form tells users to Press the button below so the loss of the button in iNotes
can confuse iNotes users who receive the form. Most iNotes users do not need the PAB Replicator form
since their address books are stored in their mail files. However, if your user population contains iNotes
users and Notes users, you may want to organize your collections to segregate the two groups and send the
PAB Replicator form only to the latter.
Migrator for Notes to Exchange offers a choice of six standard templates for the Replicator form and you can
customize any of the templates to suit your needs. The wizard also signs the selected Replicator form with the
digital keys associated with a specified administrator (identified during the program run), to authorize running the
form’s instructions on user workstations and on the server without triggering security alerts (or at least triggering
fewer of them).
NOTE: The administrator specified on the wizard Notes Login screen is identified as the sender (From) of
the form, and is the administrator whose digital keys are used to sign the form. The User ID file must be the
one that is on the ECL when sending PAB Replicators—not a separate, Quest-specific ID file that would not
be present on the ECL.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable this capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
The Advanced Settings option is a toggle that determines whether the wizards let you open and edit Task
Parameters. If the feature is enabled, the Customize Configuration screen is displayed at the start of the screen
sequence for any wizard that offers this feature.
Task Parameters are edited as if the parameters were stored in an INI file, although the parameters are stored as
part of the task definition within the SQL database. The Customize Configuration feature copies the current
parameter settings from the SQL database into a text document in Windows Notepad, so you can use the Notepad
text-editing features to change parameter values or add new parameter specifications.
NOTE: Some parameters in different sections share the same keyname, so it is very important
that parameter values be entered and edited in the correct sections.
Replicator Information
Enter the particulars of the Mail Message that will carry the upload form to users, and the Destination for the users'
PABs, and click Next.
Mail Message entries and controls:
• Template: A drop-down list to specify the template form that constitutes the body of the email message.
The wizard offers a choice of six predefined forms:
▪ PabReplicator.CopyToServer: Copies PABs to the specified Domino server directory. Does not
use mail file.
▪ PabReplicator.CopyToServer.Popups: Same as PabReplicator.CopyToServer, but also displays
informational popups (message boxes) before and after the form runs.
▪ PabReplicator.SyncAndCopyToMailFile: Performs iNotes sync if available, copies all remaining
PAB entries to mail file.
▪ PabReplicator.SyncAndCopyToMailFile.Popups: Same as the
PabReplicator.SyncAndCopyToMailFile but also displays informational popups (message boxes)
before and after the form runs.
▪ PabReplicator.SyncAndCopyToServer: Performs iNotes sync if available, copies PABs to the
specified Domino server directory.
▪ PabReplicator.SyncAndCopyToServer.Popups: Same as PabReplicator.SyncAndCopyToServer,
but also displays informational popups (message boxes) before and after the form runs.
To the right of the Template field:
Select User
This dialog box lets you select, from the Domino address book, a user to appear in the From field of the PAB
Replicator email. The name you specify in the User side of this dialog box will be inserted into the From field on
the Replicator Information screen when you click OK.
Use the add (—>) and remove (<—) features as described to select a particular user, and click OK.
Generating Task
This screen reports the wizard's progress as it determines the details and associated work items of the task you
configured. You can review (in the next screen) the details and associated work items, and decide whether to
create the task, or go back and change the specifications that define the task.
Configuration Summary
This screen shows a summary of the task configuration as defined by the information entered in previous screens.
Review the information to confirm that it describes the task you want to create. To change anything, click Back to
return to earlier screens to change values, or click Cancel to cancel the wizard and return to the Send PAB
Replicator screen in Notes Migration Manager. From earlier screens in this wizard, you can click Next to return to
this screen.
Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and filename
for the text file.
Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the destination
printer.
Run: Creates the task as defined in the configuration summary and immediately runs the task. When you click
Run, the wizard displays a screen that reports progress as the task is created and displays a screen that reports
progress as the task runs. When the task run is complete, the wizard displays a screen that reports the statistical
results of the task.
Creating Task
This screen reports the wizard's progress as it creates the task defined on the preceding Configuration Summary
screen. When the task-creation process is complete, the wizard clears this screen and runs the newly created
task.
Task Progress
The screen reports the program's progress as it performs the defined task.
You can click Cancel to cancel the task before it completes.
When the process is complete, the program displays its Task Completed screen to report the results.
Task Completed
The screen reports the results of the task run.
This screen can also display an Error Log Report button if the program encountered errors during its run. If the
Error Log Report button appears, click the button to view the program log and assess the severity of the errors.
The Error Log Report button launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you
interpret and resolve the errors.
When you are finished using the Error Log Report feature (or if the Error Log Report button does not appear),
click Exit to exit the wizard.
Introduction
The Data Migration Wizard is a multi-function application that lets you perform various functions in various
combinations in a single program run. The first screens in each program run ask what you want to accomplish. The
program proceeds through a sequence of screens, skipping screens that do not pertain to the functions you
selected.
The wizard features can be grouped into these categories
• mailbox creation (mailbox-enabling) in the target environment
• setting and removing mail routing rules in source and target
• user data migration
• administrative functions such as disabling Notes synchronization with the foreign directory, setting user
visibility in Domino, and so forth.
NOTE: Many screens described in this chapter are conditional, appearing in a wizard only when
necessary for the selected features and functions, and for the local network configuration and
designated target environment type.
Field definitions and application notes for the wizard screens appear in separate sections that follow, grouped by
screen.
Smart resource reservation detection: The Data Migration Wizard detects an attempt to migrate calendar
data for a collection in which some objects are not classified as resources in the MNE database when [Notes]
MigrateReservationsAlways is enabled (set to 1).
In that case, the wizard presents a popup warning that explains that calendars of a non-resource object may
not migrate correctly, and suggests that the MigrateReservationsAlways parameter be disabled (set to 0)
unless the administrator is certain all objects in the collection are resources. This feature offers the option of
ignoring a MigrateReservationsAlways=1 setting.
Select Configuration
This screen lets you save and recall sets of entries as templates to simplify future runs of the wizard when you
expect to have multiple runs that are similarly configured. Each configuration template consists of the entries on all
the wizard screens.
Create new configuration or select from existing templates: A drop-down list lets you select a previously
saved template or create a new configuration <Create new configuration>. Previously saved templates are listed
by the names under which they were saved (see the Name field).
If you choose <Create new configuration> from the drop-down list, the wizard displays:
• [ ] Save as template: When the option is selected, your entries in the screens are saved as a template for
future use. This option enables the Name and Description fields. The name you assign to the template
appears in the drop-down list in future wizard runs.
When you select Save as template, you can create a Full Template or a Differential template.
▪ A full template is a snapshot of the INI configuration file that was used to run a task when the
template was created. The INI file includes all the settings from the Global Default settings plus any
additions or modifications that were made by the wizard used to run the task. A full template does
not retrieve new Global Default settings after it is created.
▪ A differential template contains only the INI settings that are different than those in the Global
Default INI file rather than saving all the INI settings in the template. A differential template can
retrieve new Global Default settings.
A differential template takes precedence over the Global Default settings. Consider the following scenarios:
▪ A parameter in the Global Default settings is changed in the differential template. The differential
template setting is used.
▪ A parameter in the Global Default settings is removed from the differential template. The differential
template setting is used. Changing the setting in the Global Default settings has no impact on the
differential template.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in the Notes Migration Manager.
The Advanced Settings option is a toggle that determines whether you can open and edit Task Parameters. If the
feature is enabled, this Customize Configuration screen appears at the start of the screen sequence for any wizard
that offers this feature. To enable or disable the ability to edit Task Parameters, in Notes Migration Manager, select
View and select or clear the Advanced Settings option.
Task Parameters are edited as if the parameters were stored in an INI file although the parameters are stored as
part of the task definition in the SQL database. The Customize Configuration feature copies the current parameter
settings from the SQL database into a text document in Windows Notepad, so you can use the Notepad text-
editing features to change parameter values or add new parameter specifications.
NOTE: Some parameters in different sections share the same keyname so it is important that
parameter values are entered and edited in the correct sections.
Operations
Select the types of operations you want to perform during this run and click Next. The available function categories
that appear depend on the target Exchange environment type you have specified in Notes Migration Manager as
listed in the following topics.
NOTE: By default, the wizard preserves ACL information as it migrates Notes source data to Exchange. To
disable this feature, you can set ACLs=0 in the [General] section of Task Parameters or Global Defaults.
NOTE: If the Notes Data Locator Wizard finds a PAB or Archive twice (once by the server and again by the
file system), the Data Migration Wizard tries to migrate it twice. But the file-system attempt will fail and
generate an error because the prior successful server access locked the file, rendering it inaccessible. The
Data Locator Wizard cannot be configured to search using both methods at once, but you can run the wizard
more than once, selecting different search methods in subsequent runs.
IMPORTANT: The Prepare local AD accounts feature is a necessary administrative step that must
precede running the MS AD synchronization, and must precede running this wizard for any other
function. After running MS AD synchronization, you must run the Data Migration Wizard again and
Set Office 365 resource capacity (below) to complete mailbox-enabling in Office 365.
NOTE: When you select Prepare local AD accounts, all other options are disabled (grayed out).
When you select any other option, the Prepare Local AD accounts option is disabled.
• Set Office 365 resource capacity: Reads (from the local AD) the capacities of any resource objects in the
collection, and copies that information into the corresponding object records in Office 365 AD. Do not select
this operation until you have completed the Prepare local Active Directory accounts operation and
successfully run MS AD sync.
• Manage mail routing: Displays a screen with options for setting and removing mail-forwarding rules in the
source and target environments for all users in the designated collection.
• Notes administrative functions (includes setting visibility and directory synchronization flags):
Displays a screen with options for disabling Notes synchronization with AD, setting user visibility in Domino
or both environments, sending migration notifications to migrated users, and sending migration status
notifications to administrators.
• Office 365 administrative functions (includes password reset and license assignment): Select this
check box to display the Select Office 365 Administrative Operations screen. On that screen, you can reset
passwords and specify licensing options.
• Migrate mailbox data: Displays a screen with options for migrating user data from Notes to Exchange, in
any combination of: server-based or archived mail, calendar data, the trash folder, iNotes contacts, and/or
personal address books.
NOTE: By default, the wizard preserves ACL information as it migrates Notes source data to Exchange. To
disable this feature, you can set ACLs=0 in the [General] section of Task Parameters or Global Defaults.
NOTE: If the Notes Data Locator Wizard finds a PAB or Archive twice (once by the server and again by the
file system), the Data Migration Wizard tries to migrate it twice. But the file-system attempt will fail and
generate an error because the prior successful server access locked the file, leaving it inaccessible. The
Data Locator Wizard cannot be configured to search using both methods at once, but you could run the
wizard more than once, selecting different search methods in subsequent runs.
NOTE: By default, the wizard preserves ACL information as it migrates Notes source data to Exchange. To
disable this feature, you can set ACLs=0 in the [General] section of Task Parameters or Global Defaults.
NOTE: If the Notes Data Locator Wizard finds a PAB or Archive twice (once by the server and again by the
file system), the Data Migration Wizard will try to migrate it twice. But the file-system attempt will fail and
generate an error because the prior successful server access locked the file, rendering it inaccessible. The
Data Locator Wizard cannot be configured to search using both methods at once, but you could run the
wizard more than once, selecting different search methods in subsequent runs.
NOTE: The Data Migration Wizard can license Office 365 users when the userPrincipalName
differs from the primary SMTP address. With this feature, an administrator can use TSV Import
feature to assign alternate UPN values to the SQL database. To do this, from the Export Notes
Directory screen:
1 Export the collection SQL data to a tsv file.
2 Enter the users' UPN values into the UPN column of the tsv file.
3 Import the tsv file back into the SQL database.
MNE will read the imported UPN values, if they are present in the database, when licensing Office
365 users.
Without this feature, the wizard uses the SMTP address for the userPrincipalName, but this can
cause issues in environments where the userPrincipalName is different, since the Office 365
Administrative Operations wizard would not find the users in the target Office 365 environment.
NOTE: If a user mail file is missing or incorrectly specified, the wizard notes the error and does not migrate
the user archives or PABs, even if they are selected for migration.
NOTE: The Data Migration Wizard preserves ACL information, including calendar and task folder ACLs, as it
migrates Notes source data to Exchange. To disable this feature, you could set ACLs=0 in the [General]
section of Task Parameters or Global Defaults.
IMPORTANT: For delegates and ACLs to migrate properly the following prerequisites must be met:
• The ACL/Delegates mailboxes in Exchange must be mailbox-enabled.
• The AD profiles for users that receive migrated ACL information in Outlook must be enabled in AD. (If
the user cannot log on to Outlook, the wizard cannot migrate the ACL data.) If you inadvertently
migrate users who are not enabled in AD, you can remigrate with the RemigrateMode=0 parameter
to replace the previously migrated data (without ACLs) with new copies of the same data with ACLs.
This screen is designed to let you migrate email messages, calendar data, and the trash folder independently from
the server and/or from the archives.
• Migrate mail data: You can specify one or more of email messages, “Active Mail,” calendar data, task
data, the trash folder, and/or iNotes contacts.
NOTE: Active Mail processing is an optional feature that is disabled by default but can be enabled by
the following check box, under the Migrate mail data check box:
[] Migrate Active Mail [Configure]
This Migrator for Notes to Exchange feature can detect and convert Notes rich-content features
whereby messages carry “live” or “active” functional content. For more information about Active Mail,
see Migrating Notes “Active Mail” in chapter 3 of Migrator for Notes to Exchange’s Pre-Migration
Planning Guide.
To enable Active Mail processing: Select the Migrate Active Mail check box, click Configure and enter
your preferences in the pop-up dialog box:
Active Mail types to migrate:
[ ] Encrypted mail
[] Stored forms
[] Hotspots
[] Rich markup
Active Mail template: [_________________] [...]
Notification message: [_________________] [...]
Attachment name: [_________________]
Click OK to save your preferences and return to the Specify Data to Migrate screen.
The Notification message (whose file path is specified in the dialog box) is a file containing a text string
that the wizard inserts at the top of the body of any migrated message containing Active Mail. MNE installs
a default file, ActiveMailNotificationMessage.txt, to the installation directory, but you can specify a different
filename and/or folder in the dialog box.
The text file must be UTF-8 encoded and must contain a placeholder, called $ActiveMailAttachment$, that
MNE replaces with the Active Mail NSF attachment when the message is migrated. Since the contents of
this text file become part of an RTF body, characters such as "\", "{", and "}" must be escaped with a leading
"\" (so they become, respectively, "\\", "\{", and "\}").
• Migrate archives: You can specify one or more of email messages, calendar data, task data, and/or the
trash folder.
NOTE: If Contacts were migrated to a folder other than the default Contacts folder, the wizard
will remigrate Contacts only to the same folder, even if you specify a different folder name. To
remigrate Contacts to a different folder name, you must hard-delete the previous Contacts
folder and its contents. If you try to remigrate Contacts to a different folder name without
deleting the previous folder, the wizard migrates them (excluding duplicates) to the previous
folder.
▪ Migrate recent contacts into folder named: Enter the name for the folder that will contain the
migrated PABs' Recent Contacts lists.
▪ Set contact 'File as' to: 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:
▫ Use current display name: Use the Display Name attribute of the address book entry. By
default, the wizard 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.
NOTE: The Domino webserver option is incompatible with an Offline migration (as described in
chapter 1 of the Migrator for Notes to Exchange Scenarios Guide), since MNE cannot connect to an
offline Domino server to perform the DocLink translation.
• HTML links to your SharePoint Server: A SharePoint server link will point to a document on a separate
SharePoint server. This requires that you have Notes Migrator for SharePoint (formerly “Proposition Portal
format”). If you select the SharePoint option, you must also specify:
▪ Site Address: URL to location of these documents on the SharePoint server.
• Through the file system: Migrates the user server-based mail through the file system from source files
located in an earlier run of the Notes Data Locator Wizard in subtrees located by the wizard, or in the path
specified by the MailFilePath column of the SQL database.
NOTE: When migrating to .pst files, the UseSeparatePSTs parameter (in the Global Defaults and
Task Parameters) lets you specify whether the wizard should migrate all data into a single .pst file per
user, or to multiple .pst files. For more information, see in Appendix A: How Do I Specify Whether to
Migrate to a Single PST File (Per User) or Multiple PST Files?
NOTE: PAB or Archive Notes data will be duplicated in Exchange if you remigrate to the server and
use a different method (server vs. file system) than the first migration. No duplicates will occur when
migrating to PSTs. Any duplicate archives on the server appear in a duplicate folder with the digit “1”
appended to the folder name.
NOTE: The Data Migration Wizard lets you remove and set mail-forwarding rules, and move user data, all in
a single run of the wizard. The wizard always performs the “remove forwarding” function first (per user),
before setting the new forwarding rule in the corresponding mailbox, to prevent mail looping. (If an Exchange
mailbox and its corresponding Notes mailbox are simultaneously set to forward mail to each other, any new
mail arriving in either mailbox would loop endlessly between the two.) As an additional precaution, the wizard
verifies the success of each remove function before setting the new forwarding rule in Notes.
Each of the items in this screen offers a "pick one of the following" choice of two or more options. Specify your
choice for each item, and click Next.
• All new mail for users in the collection will be delivered to: Sets the direction of the mail-forwarding
rules you want to set and remove, and determines which screens the wizard will display to collect the
necessary information:
▪ Notes: Facilitates target-to-source (Exchange to Notes) mail forwarding. The wizard displays the
screens that let you set the forwarding rule in Exchange and let you remove any existing forwarding
rules in Notes.
NOTE: Select the Quest Coexistence Manager for Notes option if you are using CMN for
email remediation with SMTP mail routing. Designating CMN for mail routing here will process
user objects in a way that requires using the CMN option as the method for Calendar
coexistence (next field). If you select CMN here, the wizard selects the CMN option for your
calendar coexistence method.
▪ SMTP: Uses SMTP addressing for mail routing, but requires admin configuration of Notes person
documents and AD object records.
This option can be useful when using CMN for coexistence and new mail goes to Exchange, if users in a
single collection but two different Domino domains migrate with mail routing. This option could be used to
not include the same domain for every user, when it is incorrect for some users. Other adments may be
needed outside of Migrator for Notes to Exchange to make free/busy or mail coexistence work.
Sample address: An illustration of the format of a complete forwarding address, as defined by your two
preceding entries. An informational display only, this value can be changed only indirectly, by changing
either or both of the two preceding entries.
• Overwrite existing mail forwarding address: Select one of three options to indicate whether the
forwarding address as defined on this screen should overwrite any existing mail-forwarding rules the
wizard may find already in place for a user:
▪ Only if domain matches “Forwarding mail domain”: Overwrites an existing forwarding address
with the new forwarding address as defined only if the domain of the old address is the same as the
specified Forwarding mail domain. This is a precaution to prevent the inadvertent overwriting or
removal of existing forwarding that have nothing to do with migration.
▪ Always: Always overwrites any existing forwarding address with the new forwarding address as
defined on this screen.
▪ Never: Never overwrites existing forwarding address with the new forwarding address—it skips the
mail-routing function for any user whose Notes account already contains a mail-forwarding.
• Verify source forwarding address in target mail system: Determines whether the wizard verifies the
existence of each target forwarding address in Active Directory before setting it as a forwarding address in
Domino. This check box is selected by default. Validating the AD address can cause problems when an
email address does not exist in AD (for example, in an Office 365 or other hosted-Exchange migration),
since MNE does not set the forwarding address in Notes. Quest recommends that you clear the check box
for an Office 365 or other hosted-Exchange migration.
Many migrating organizations configure the user Exchange accounts to forward mail to the corresponding
mailboxes in Notes for any mail that arrives in Exchange before the users are migrated. As each user group
migrates, the original forwarding rule in Exchange must be removed and a new forwarding rule is set in Notes so
any mail arriving in Notes is routed to the corresponding mailbox in Exchange. If the Notes-to-Exchange
forwarding rule is set before the Exchange-to-Notes rule is removed, new mail arriving in either mailbox will loop
endlessly between the two—a phenomenon known as mail “looping.” This screen collects the information that the
wizard needs to remove any previously set mail-forwarding rules in Exchange.
Enter the requested information in this screen, and click Next.
• Remove directory synchronization exclusion (This check box is enabled only when CMN Coexistence
is specified): Removes an attribute set by CMN that allows the object to sync back to the other system.
Mail forwarding address options:
• Remove mail Forwarding address: Select this check box if you want to remove previously set mail-
forwarding rules it may find in Exchange, per the Only if... vs. Always option selected.
• Remove existing forwarding address:
▪ Only if domain matches “Forwarding mail domain”: Removes previously set mail-forwarding
rules found in Exchange only if the domain in the found address matches the specified Forwarding
mail domain. This is a precaution to prevent the inadvertent overwriting or removal of existing
forwarding that have nothing to do with migration.
▪ Always: Removes all previously set mail-forwarding found in Exchange, regardless of the
Forwarding mail domain.
NOTE: Migrator for Notes to Exchange’s Exchange-to-Notes mail forwarding ordinarily sets the MailServer
attribute in a Notes Person document in flat format (i.e., ServerName/DomainName). In some environments,
however, that practice can inadvertently disable mail routing. In that case, the problem may be resolved by
setting the MailServer attribute in canonical format (i.e., CN=<server>/O=<domain>).
A boolean program parameter determines how the Data Migration Wizard will format the MailServer attribute
when configuring Exchange-to-Notes forwarding. For example:
[Notes]
UseCanonicalForwardingServerName=1
... tells the wizard to write the attribute in canonical format (CN=ServerName/ O=DomainName), which is
suitable for mail routing via CMN, but not via SMTP. By default (UseCanonicalForwardingServerName=0)
the attribute is set in flat format: ServerName/DomainName.
NOTE: The Data Migration Wizard lets you remove and set mail-forwarding rules, and move user data, all in
a single run of the wizard. The wizard always performs the “remove forwarding” function first (per user),
before setting the new forwarding rule to prevent mail looping. The wizard also verifies the success of each
remove function before setting the new forwarding rule.
NOTE: If there is no valid user mail file specified in its SQL database, this Set mail system field must
be set to None or the wizard will ignore all these Notes forwarding attributes settings.
• Set format preference: Select this check box and use the drop-down list to select the appropriate value to
set for the Notes parameter, Format preference for incoming mail. The wizard sets this value to Prefers
MIME upon users’ migration to Exchange; this field lets you restore the prior value (typically Keep in
senders’ format) if you prefer. Select Prefers MIME setting if you will use CMN without Active Mail
remediation, or select Keep in senders’ format to use CMN with Active Mail.
• Allow foreign directory synchronization: Lets the CMN Directory Connector extract user data from the
Domino directory during its dirsync. (This corresponds to the Notes parameter Allow foreign directory
synchronization.) To disable foreign directory sync, leave the check box selected but select Disable in the
drop-down list. Sometimes migrated objects that have been merged or mailbox-enabled in AD become
unrecognizable to a Notes' directory update, so the update mistakenly creates duplicate objects in AD. You
should Disable foreign directory sync if:
▪ You are using the CMN Directory Connector to perform directory updates from Notes to Exchange
during coexistence; and
▪ Your mail-routing method during coexistence is to use Notes forwarding addresses to set forwarding
from Notes to Exchange; and
▪ The Notes person documents are not set to turn users into Exchange objects.
Mail forwarding address options:
• Remove mail forwarding address: Select this check box if you want the wizard to remove previously set
mail-forwarding rules it may find in Notes, per the Only if... vs. Always option selected below:
▪ Only if domain matches “Forwarding mail domain”: Removes the previously set Forwarding
address (a Notes parameter) found in Notes only if the domain in the found address matches the
Forwarding mail domain specified in the accompanying text box. This would be a precaution to
prevent the inadvertent overwriting or removal of existing forwarding addresses that have nothing to
do with migration.
▪ Always: Removes the previously set Forwarding address (a Notes parameter) found in Notes,
regardless of Forwarding mail domain.
NOTE: Setting visibility to System here will not restore the visibility of a user who has been manually
hidden in Notes.
NOTE: If you have multiple Global Catalogs/Domain Controllers in an AD forest, you may choose any
GC in the setup as long as it is in the same domain.
IMPORTANT: If migrating to an Exchange on-premises server, you must enter fully qualified domain
names for the Global Catalog host name and Domain Controller host name.
• Domain Controller host name: Specify the PowerShell Domain Controller that Migrator for Notes to
Exchange will call to perform operations in Exchange.
• User name: The user name of the administrator by whose authority the program will access the Active
Directory.
• Password: The password associated with the user name.
Click Next.
NOTE: The wizard will perform (or attempt) the mailbox-enabling functions by the authority of
whatever user is running the Notes Migration Manager— not necessarily the same as the user whose
AD credentials are entered into the Active Directory Configuration screen of Notes Migration
Manager.
Personal Archives:
• Enable Exchange Personal Archive (available only when migrating to Exchange 2010 or later, or Office
365): Select this check box if you want the wizard to create a new Personal Archive mailbox in Exchange
for each user in the collection. This is required if you want to migrate any data to Personal Archives (as
specified in the Select Destinations for Migrated Data screen, earlier in this Wizard).
• Use alternate mail store for Personal Archives (disabled if migrating to Office 365): Select if you want to
specify a separate mail store for Exchange Personal Archives (separate from the active mailbox—e.g., to
distribute storage). If you select this option, you must also specify, from the drop-down lists, the locations of
the alternate mail server and alternate mailbox database.
Click Next.
NOTE: Even if you filter attachments based on size, all messages are migrated. The filter excludes
only attachments that exceed the size limit; the messages to which oversized attachments were
attached are still migrated.
If Office 365 is selected as the Target Exchange System: The Attachment size defaults to 24.5
MB, which is the maximum message size allowed by Office 365. If the limit is set higher than Office
365 allows, the program reads and attempts to migrate larger attachments, but they will be
disallowed by Office 365 and logged as an error unless the migration has the [Exchange]
MigrateOversizedAttachments feature enabled in which the program attempts to upload large
attachments to the user OneDrive store.
For Office 365, you can configure MNE to migrate oversized attachments to the Microsoft OneDrive
store associated with the user mailbox. For details, see Exchange Server Configuration: Migrating to
Office 365 on page 20.
• Do not connect to an Exchange server: This feature makes possible the migration of data to Outlook
personal folder (.pst) files prior to the setup of your Exchange server, but the check box will be available
only if none of your entries on earlier screens will require a connection to an Exchange server. (For
example, if you have told the program to create Exchange mailboxes, or to migrate any data to server-
based mailboxes, this check box will appear grayed-out and unavailable.) If you do forgo a connection to
an Exchange server, attendees’ free/busy information will be unavailable in migrated calendar
appointments.
• If you are migrating to Exchange 2013, 2016, or 2019:
Exchange Mailbox Server: Name of the Exchange server, which has the Mailbox role installed on it and
will be the connection used for all Exchange PowerShell activities in the product.
• If you are migrating to Exchange 2010:
Exchange CAS Server (displayed when migrating to Exchange 2010): Name of the client-access server (a
specific CAS server, not the array), if any.
NOTE: If migrating to a CAS, you must also set a throttling policy and WinRM, as described in
Appendix A (see How Do I Migrate to an Exchange Environment with a CAS Array?).
NOTE: When migrating to .pst files, a program parameter in the Global Defaults and Task
Parameters lets you specify whether the wizard should migrate all data into a single .pst file per user,
or to multiple .pst files. See in Appendix A, How Do I Specify Whether to Migrate to a Single PST File
(Per User) or Multiple PST Files? for information about this option.
The options to specify the .pst output file name and directory are listed below.
• Subdirectories of root directory specified below: Places .pst files in subdirectories under the .pst output
root directory designated in the accompanying text box. This option creates a directory structure that
matches the user's Notes folder hierarchy.
When this option is selected, you must also specify the file name format in the Generate the .pst filename
using field.
• Directory specified by the PSTDir column from database: Places new .pst files in the directory
specified for each user in the PSTdir column of the SQL database. The PSTdir column values must be in
the SQL database prior to this program run (see the Pre-Migration Preparations in chapter 2 of the Migrator
for Notes to Exchange Scenarios Guide).
▪ Generate the .pst filename as: When this check box is enabled, you can enter a file name string in
the text field. When the check box is disabled, you must specify the file name format in the
Generate the .pst filename using field.
▪ Generate the .pst filename using: You can select one of the following options for the .pst file name
format:
▫ Source Notes filename
▫ User display name
▫ User id
▫ SMTP email address
▫ Notes email address
In addition to specifying the location for new .pst files, you must also specify the file format (by Outlook version) for
which you want the files created:
• Use Outlook 97-2002 Personal Folders File (.pst): Tells the program to format .pst files in this format
(supports 2GB of data).
• Use Office Outlook Personal Folders File (.pst): Tells the program to format the .pst files in this format,
which supports up to 20GB of Unicode data. This option requires that Outlook 2010 be installed on the
migration machine, and will otherwise appear grayed-out as an unavailable option.
You can specify a language for personal archive folder names using the [General] LanguageCode parameter.
See the Programming Parameters Reference guide.
Migration Prioritization
This screen allows you to prioritize a specific user or users in the migration queue.
The screen shows the list of users currently in the migration queue. The Row count field displays the number of
users currently in the queue.
The table provides the user’s Display Name and SMTP Address. It also provides following information regarding
the migration data for each user:
• Data Store Estimate Item Count
• Data Store Estimate Item Size
For both fields, if you select Migrate mail data and Migrate archives on the Specify Data for Migration screen,
the estimates include both mail and archive data.
To change the priority of a user, select the user and click Move to change the user’s position in the list. Users at
the top of the list are migrated first. To select multiple users, press and hold the Shift key.
You can click on the column headers to reverse the order of the list. For example, click Data Store Estimate Item
Count to move users with the least amount of data to the top or bottom of the list.
Click Next to move to the next screen. If you opened this window from the Task Progress window, click Apply to
save your changes and close the window.
Configuration Summary
This screen shows a summary of the task configuration you have specified, as defined by the information entered
in previous screens.
Review this information to confirm that it describes the task you want to create. If you want to change anything,
click Back to return to earlier screens in this Wizard, to change values as necessary, or click Cancel to cancel this
wizard and return to the Migrate User Data screen in Notes Migration Manager. From earlier screens within this
wizard, you can click Next to return to this Configuration Summary screen.
• Next: Creates the task as defined in the configuration summary and immediately runs the task. When you
click Run, the wizard displays a screen that reports progress as the task is created and displays a screen
that reports progress as the task runs. When the task run is complete, the wizard displays a screen that
reports the statistical results of the task.
Creating Task
No information is entered into this screen, which reports the wizard's progress as it creates the task defined on the
preceding Configuration Summary screen.
When the task-creation process is complete, the wizard clears this screen and runs the newly created task.
NOTE: The Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, explained in chapter 13 of the Migrator for
Notes to Exchange Administration Guide. The Task Scheduler checks the SQL database to see whether any
tasks are scheduled to run since the last check, and runs any tasks it finds.
The drop-down list at the top of the screen offers these scheduling options:
• Now on this computer: The wizard runs the task when you click Next. The other scheduling controls on
the screen appear grayed out (unavailable), since they do not apply. Click Next to display the Task
Progress screen.
• One or more times, as indicated below: The task runs one or more times, according to your entries in the
scheduling controls. If you select this option you must specify where and when you want the task to run in
the scheduling controls.
• Manually: The task will not run or be scheduled. The other scheduling controls on the screen appear
grayed out (unavailable), since they do not apply. Click Next to display the Schedule Summary screen.
• Once: The task will run only once and will not repeat. You can specify where to run and the start date and
time. Click Next to display the Schedule Summary screen.
These scheduling controls are enabled only if One or more times... is selected in the drop-down list:
• Where to run: Select either On any computer or On a specific computer. If you choose a specific
computer, you must also specify the machine name in the text box.
• When to run:
▪ Start: Specify the calendar date for the first (or only) task run.
▪ Days of the Week: Specify one or more days of the week that you want the task to run. If you select
two or more days, the first task run will occur on the first selected day occurring on or after the
specified Start date.
▪ Between [____] and [____]: Specify the beginning and ending times of a range of start times for
the task to run.
▪ Select one of these options for the end date:
▫ No end date: The task runs will adhere to this schedule until someone manually ends the
series by editing this schedule definition in Notes Migration Manager (in the Manage
Scheduled Operations screen).
▫ End after __ occurrences: The task runs will adhere to this schedule until the cumulative
number of runs matches the number specified here.
▫ End by: The task runs will adhere to this schedule until the calendar date specified here
▪ [_] Start this task only after completing: [________________________]: Select this check box if
you want this new task to run only after some other previously defined Migrator for Notes to
Exchange task has run. If you select the check box, use the drop-down list to specify which
previously defined Migrator for Notes to Exchange task must precede this one.
When you have set the task schedule in these scheduling controls, click Next to display the Schedule Summary
screen.
Schedule Summary
This screen appears only if you have selected One or more times... Once or Manually as your scheduling option
on the preceding Specify Task Schedule screen. The screen shows a summary of the task schedule you specified
in the Specify Task Schedule screen, or notes that the task will be run only Manually.
Task Progress
No information is entered into this screen. The screen reports the program's progress as it performs the defined
task. You can click Cancel to cancel the task before it completes.
You can click User Status to open the User Migration Status window. This window displays detailed per-user
migration status in real time during the migration. In the User Migration Status window, click Export to TSV to
create a local tsv file containing the data. Click View Error Log to open the Log Viewer.
You can click Prioritization to open the Migration Prioritization window and prioritize a specific user or users in the
migration queue. See Migration Prioritization.
When the process is complete, the program displays its Task Completed screen to report the results.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
Click User Status to open the User Migration Status window. This window displays detailed per-user migration
data. In the User Migration Status window, click Export to TSV to create a local tsv file containing the data.
NOTE: Notes stores RTF message bodies in compressed form, but in this screen, MNE reports the volume
of migrated data as uncompressed bytes, and the data is also stored uncompressed in Exchange mailboxes.
The migrated data volume that is reported here, and the corresponding mailbox sizes in Exchange, are likely
to be somewhat larger than the data volume reported in the Notes source in which RTF message bodies are
compressed.
• if the program encountered errors during its run, the Task Completed screen displays an Error Log Report
button. Click the button to view the program log and assess the severity of the errors. The Error Log
Report button launches the MNE Log Viewer utility to help you interpret and resolve the errors. For more
information see “The Log Viewer” chapter in this guide.
• If a migration included Notes messages that were scheduled to be delivered on a future date, MNE
generates a deferred email report file (DeferredEmails.tsv) in the shared log folder and the Task Completed
screen displays a Deferred Email Report button. Click the button to view the DeferredEmails.tsv log file.
For more information see the “Migrating delayed delivery mail” chapter in the Pre-Migration Planning
Guide.
When you are finished, click Exit to exit the wizard.
Introduction
The SSDM Statistics Collection Wizard defines a task that will gather migration statistics written by the Self-
Service Desktop Migrator (SSDM, and loads the data to the SQL database, so you can track the progress of a
migration project.
NOTE: The SSDM Statistics Collection Wizard can collect user statistics only if the Post user logs to the
central directory check box has been selected in the Shared Directories Configuration screen in Notes
Migration Manager. If that check box has been left cleared, the per-desktop migration program will have
written its log files to individual users' local temp directories, where they will be unavailable to the wizard.
Each time a user runs the Self-Service Desktop Migrator, the program writes its run statistics to the Directory for
central log and status files, specified in the Shared Directories Configuration screen of Notes Migration
Manager. This Wizard gathers those statistics and adds them to the SQL database, so they will appear in the
Project View screen of Notes Migration Manager.
NOTE: Statistics reported by Migrator for Notes to Exchange are based on uncompressed data sizes
provided by the Notes APIs. The APIs extract data in compressed form and provide the data to Migrator for
Notes to Exchange in an uncompressed state. Data volumes reported by Migrator for Notes to Exchange are
often higher than the values observed natively in Notes or transferred over the network to the migration
servers.
Field definitions and application notes for the wizard’s screens appear in the sections that follow.
Customize Configuration
This screen, which lets you edit the Task Parameters for this task, appears only if the Advanced Settings option is
selected on the View menu in Notes Migration Manager. To enable or disable this capability to edit Task
Parameters:
• In Notes Migration Manager, on the View menu, select (enable) or clear (disable) the Advanced Settings
option.
The Advanced Settings option is a toggle that determines whether the wizards will let you open and edit Task
Parameters. If the feature is enabled, the Customize Configuration screen is displayed at the start of the screen
sequence for any Wizard that offers this feature.
NOTE: Some parameters in different sections share the same keyname, so it is very important that
parameter values be entered and edited in the correct sections.
Generating Task
No information is entered into this screen.
This screen reports the wizard's progress as it determines the details and associated work items of the task you
have prepared.You can review (in the next screen) the details and associated work items, and decide whether to
create the task, or go back and change any specifications that define the task.
When the process is complete, the wizard displays the next screen.
Configuration Summary
This screen shows a summary of the task configuration you have specified. The Configuration Summary for this
wizard shows only the directory that contains the statistics files written by the Self-Service Desktop Migrator. The
source directory was specified in the Notes Migration Manager, in the Gather Desktop Statistics screen from which
this wizard was launched.
Review this information to confirm that it describes the task you want to create. If you want to change anything,
click Back to return to earlier screens to change values as necessary, or click Cancel to cancel this wizard and
return to the Gather Desktop Statistics screen in Notes Migration Manager. From earlier screens, you may click
Next to return to this Configuration Summary screen.
• Save As: Lets you save this summary information to a text file. Follow the prompts to specify a path and
filename for the text file.
• Print: Lets you print a paper copy of this summary information. Follow the prompts to specify the
destination printer.
• Run: Creates the task as defined in the configuration summary and runs the task. When you click Run, the
wizard displays a screen that reports its progress as it creates the task, and displays a screen that reports
its progress as the task runs. When the task run is complete, the wizard displays a screen that reports the
statistical results of the task.
NOTE: The Manage Scheduled Operations screen manages the scheduling of task runs as saved in the
SQL database. Scheduled tasks are run by the Task Scheduler, explained in chapter 13 of the Migrator for
Notes to Exchange Administration Guide. The Task Scheduler checks the SQL database to see whether any
tasks have been scheduled to run since the last check, and runs any tasks it finds. See chapter 13 for details
on the Task Scheduler.
The drop-down list at the top of the screen offers these scheduling options:
• Now on this computer: Runs the task when you click Next. The other scheduling controls on the screen
appear grayed out (unavailable), since they do not apply. Click Next to display the Task Progress screen.
• One or more times, as indicated below: The task runs one or more times, according to your entries in the
scheduling controls. If you select this option you must specify where and when you want the task to run in
the scheduling controls.
• Manually: The task will not run or be scheduled. The other scheduling controls on the screen appear
grayed out (unavailable), since they do not apply. Click Next to display the Schedule Summary screen.
• Once: The task runs only once and will not repeat. You can specify where to run and the start date and
time. Click Next o display the Schedule Summary screen.
These scheduling controls are enabled only if One or more times... is selected in the drop-down list:
• Where to run: Select either On any computer or On a specific computer. If you choose a specific
computer, you must also specify the machine name in the adjacent text box.
• When to run:
▪ Start: Specify the calendar date for the first (or only) task run.
▪ Days of the Week: Specify one or more days of the week that you want the task to run. If you select
two or more days, the first task run will occur on the first selected day occurring on or after the
specified Start date.
▪ Between ____ and ____: Specify the beginning and ending times of a range of start times for the
task to run.
▪ Select one of these options for the end date:
▫ No end date: The task runs will adhere to this schedule until someone manually ends the
series by editing this schedule definition in Notes Migration Manager (in the Manage
Scheduled Operations screen).
▫ End after __ occurrences: The task runs will adhere to this schedule until the cumulative
number of runs matches the number specified here.
▫ End by: The task runs will adhere to this schedule until the calendar date specified here.
▪ [_] Start this task only after completing: [________________________]: Select this check box if
you want the new task to run only after some other previously defined task has run. If you select the
check box, use the drop-down list to specify which previously defined task must precede this one.
When you have set the task schedule in these scheduling controls, click Next to display the Schedule
Summary screen.
Task Progress
No information is entered into this screen. The screen reports the program's progress as it performs the defined
task. You can click Cancel to cancel the task before it completes.
When the process is complete, the program displays the Task Completed screen to report the results.
Task Completed
No information is entered into this screen. The screen reports the results of the task run.
if the program encountered errors during its run, the Task Completed screen displays an Error Log Report button.
Click the button to view the program log and assess the severity of the errors. The Error Log Report button
launches the MNE Log Viewer utility (see The Log Viewer chapter) to help you interpret and resolve the errors.
When you are finished, click Exit to exit the wizard.
IMPORTANT: The full benefit of the Log Viewer requires that the application to transmit log event codes from
the computer hosting the Log Viewer to a remote Quest database of Solutions (useful information about the
events associated with the log codes). The Quest Solutions database sends a corresponding Solution back
to the Log Viewer for display to the user.
This feature is enabled by default, but can be disabled by clearing the Enable Internet Access option on the
View menu. For more information, see the IMPORTANT disclosures in the View menu topic that follows, in
the field notes for the Enable Internet Access option.
These Log Viewer topics document Log Viewer menus and toolbar and How to ... (accomplish various tasks).
Several features are also available directly from the keyboard, and those keyboard shortcuts are displayed in the
menus and noted here.
The Log Viewer menus are: File menu • Edit menu • View menu • Help menu
File menu
• Open Log File... (or Ctrl+O): Opens a standard Windows Open dialog box from which you can specify the
file you want to open in the Log Viewer. The Log Viewer can open and display WLog (optionally
compressed) files and plain text files.
NOTE: Drag-and-Drop Option: You can also open a wlog file in the Log Viewer by dragging and
dropping a filename from Windows Explorer into the Log Viewer window.
• Save Copy Of Log File As... (appears when a file is open): Opens a standard Windows Save As dialog
box, from which you can specify the filename and location where you want the file to be saved. The Log
Viewer lets you edit the contents of an open file, but does not replace the original on disk with the edited
version (you cannot save it under the same name in the same location).
• Recent Files: Shows a list of recently opened files from which you can select a file to re-open (to quickly
re-open a file you have recently viewed and closed).
Edit menu
• Copy (or Ctrl+C): Copies the selected line to the Windows clipboard.
• Find... (or Ctrl+F): Opens a Find dialog box that lets you specify a text string to search for within the open
file:
The dialog box lets you search for the next or preceding occurrence, or for the first or last occurrence in the
file. The Find feature highlights the entire line that contains the target string.
• Go To Line Number: Opens a dialog box that lets you jump to a particular line number of the file. (Enter
the line number and click OK.)
View menu
• Show Line Numbers (or Ctrl+L): Toggles the display of line numbers (within the open file) on and off.
• Show Complete Log Entry (or F5): Opens a Log Detail window that shows the entire string for the
selected item—useful when the item text overruns the Log Viewer’s maximum line length (maximum 259
characters), or if the line extends beyond the right edge of the viewer window without wrapping.
• Enable Internet Access: Toggles the Internet connection on and off. Note these important disclosures:
IMPORTANT: The Quest Log Viewer requires that the application transmit log event codes from the
computer hosting the Log Viewer to a remote Quest database of Solutions (useful information about
the events associated with the log codes). The Quest Solutions database sends a corresponding
Solution back to the Log Viewer for display to the user.
This feature is enabled by default, but you can disable it by clearing the Enable Internet Access
option on the View menu. Note:
• The Log Viewer sends event codes to Quest servers in the United States, as the codes
appear in a log file that has been opened into the Log Viewer window.
• The Log Viewer sends only event codes and source IP addresses to Quest's server. No
personally identifying information other than IP addresses is collected or sent.
• Quest's transmission of Solutions corresponding to received event codes is fully automated
(no human intervention or observation). Quest tallies the frequencies of event codes received
and Solutions sent in reply, but does not associate those tallies with IP addresses or any other
personally identifying information, and no other information is logged.
• Quest servers treat each received event code as a query. Quest uses an event code only to
determine which Solution to send back to the source of the query, and uses an IP address
only to transmit the Solution to the source of the query. Quest servers log querying IP
addresses as a matter of course, but Quest does not use them for any other purpose and
does not disclose them to any other entity.
• You may opt out of this feature, to prevent the transmission of event codes and IP addresses
to Quest, by clearing the Enable Internet Access option on the View menu.
• Goto Line Number: Prompts for a line number in the file to display.
Help menu
• Online Help... (or F1): Opens Quest’s online Help file for the Log Viewer, which documents its features.
How to ...
This section describes how to accomplish various tasks in the Log Viewer.
TIP: If the Migrator for Notes to Exchange Task Scheduler experiences logon failures when trying to start the
service, see How do I troubleshoot service startup permissions? in the How Do I ...? Appendix of the
Migrator for Notes to Exchange Administration Guide.
When used, the task scheduler service polls the Migrator for Notes to Exchange database at regular intervals for
any scheduled tasks and invokes the qsched.exe utility to run those tasks at the designated times.
Post-installation configuration
After installing MNE, there are additional configuration steps required to use the Migrator for Notes to Exchange
Task Scheduler utility. Open the Windows Service Manager and complete the following steps:
1 Ensure the task scheduler service is configured to run on behalf of an account that has the necessary
permissions to access all MNE resources. It is recommended that you use the same account that is used to
run the MNE console. The display name of the task scheduler service is “Quest Migrator for Notes to
Exchange Task Scheduler”.
2 Configure the Quest Migrator for Notes to Exchange Task Scheduler service for autostart mode.
a If the MNE database is located on a local SQL instance, configure the service to start in the
Autostart (Delayed Start) mode.
b If the MNE database is located on a remote SQL instance, configure the service to start in the
Autostart mode.
3 Start the task scheduler service.
IMPORTANT: Since a non-privileged user cannot create a reminder task (by Windows
policy) and would not be alerted if the task could not be scheduled, an administrator
should not allow this scheduled-reminder option for users that lack that privilege.
▫ Email Migration Team: Determines whether the SSDM will be enabled to notify the
migration administrator in the event the program cannot run due to scheduling restrictions.
The Auto Send Email field determines whether the notification is generated, or if an option
posed to the SSDM user. If Email Migration Team is cleared, the program does not auto-
matically send an email or offer the option to users.
IMPORTANT: If this feature is disabled, the Report This Issue button will not appear
to the user, so the message defined in the Custom Notifications panel should not
mention the button.
▫ Auto Send Email (valid only if Email Migration Team is selected): Determines whether the
SSDM notifies the migration administrator in the event the program cannot run due to
scheduling restrictions. If this box is selected and the SSDM is unable to run, the program
generates notification emails to the migration administrator defined in the Migration Team
Email Information fields. If this box is cleared and the SSDM is unable to run, the error
screen presented to the user includes a button that lets the user choose whether to send a
notification to the migration team.
b Set values for the update and timeout fields:
IMPORTANT: The default text entries for the “Before” and “After” conditions noted here and
below make no mention of the Schedule Reminder button—an option that may or may not be
offered depending on your setting for Schedule Reminder in the Global Settings panel (step
5a). If the Schedule Reminder option is enabled, you should add brief explanations of the
button to the messages here.
▪ After Migration Window Notification: The message that is shown if the user tries to run the
SSDM after the latest date and time set for his/her collection’s migration window.
▪ Before Migration Time Window Notification: The message that is shown if the user tries to run
the SSDM within the migration window date range, but before the permitted time-of-day range. Also
see the IMPORTANT note above.
▪ After Migration Time Window Notification: The message that is shown if the user tries to run the
SSDM within the migration window date range, but after the permitted time-of-day range. Also see
the IMPORTANT note above.
▪ Too Many Connections Notification: The message that is shown if the number of other users
running the SSDM at the same time has reached the concurrency limit set for the collection.
When all the Custom Notifications field values are set as you want them, click Save to save the settings.
7 Click the Collection Settings tab to show that panel, and:
a Select a collection from the list of Collections on the left. The fields in the right half of the screen will
set the schedule “window” and concurrent usage limit for all users in the selected collection.
NOTE: To define a new collection while in this Collection Settings panel, click the Add/Edit
Collection button (below the Collections list, on the left) to launch the Collection Wizard.
NOTE: When running Migrator for Notes to Exchange in a federated Office 365 environment, the Account
Pool Utility cannot use a federated domain.
Since Microsoft’s throttling is applied per administrator account, Migrator for Notes to Exchange runs multiple
administrator accounts simultaneously on separate machines, each set to migrate with only one thread at a time.
The net throughput becomes a function of the sum of all these multiple accounts’ processing threads—one per
administrator account.
Migrator for Notes to Exchange includes an Admin Account Pool utility that helps you manage a pool of Office 365
administrator accounts for this purpose. The utility is designed to help you coordinate and "choreograph" these
administrator accounts.
NOTE: To maximize the performance of concurrent migration threads, ensure the size of the pool is greater
than or equal to the total number of threads across all migration servers.
Before you use the Admin Account Pool for the first time
These steps are mandatory before you can use the Admin Account Pooling utility the first time.
NOTE: If you set the New pool size to 0, or otherwise reduce the pool size, any licenses
associated with accounts no longer in the pool become available for other accounts.
▫ License Admin Pool Accounts: Select the check box to assign Office 365 licenses to
these accounts, or clear the check box to dissociate Office 365 licenses from these
accounts.
NOTE: Microsoft Office 365 licenses are transferable, so they can be reassigned after they are
disassociated from these accounts. Note that this dissociation also deletes any Office 365 mailbox
that may have been created for the account but admin accounts created for this purpose typically do
not need or use Office 365 mailboxes.
3 When you have entered the changes you want, click Apply.
The Apply button applies the changes, automatically synchronizes with Office 365, and refreshes the table
display.
4 Click Close.
While any of these operations are in progress, the status bar at the bottom of the screen displays progress
information, and the Close button temporarily changes to a Cancel button.
Common Parameters
In addition to the cmdlet-specific parameters documented following, all these cmdlets support the common
parameters that Microsoft builds into all PowerShell cmdlets, as described in the Microsoft article
about_CommonParameters.
Cmdlets in Quest.MNE.Powershell
Add-MNECollectionMember
Synopsis
Adds a member object to the specifies collection.
Syntax
Add-MNECollectionMember [-CollectionGuid] <Guid> [-ObjectSmtpAddress] <string>
[<CommonParameters>]
Parameters
-CollectionGuid <Guid>
The Guid of the collection to add the member to.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ObjectSmtpAddress <string>
The SMTP address of the object to be added to the collection.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ObjectGuid <Guid>
The Guid of the object to be added to the collection.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
Accepts pipeline input for the collection guid.
Outputs
QuestSoftware.NMEAPI.Controllers.NMECollection
Outputs the collection that was added to, if there are no errors.
Examples
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
128
PowerShell cmdlets for Migrator for Notes to Exchange
PS C:\>Add-MNECollectionMember -CollectionGuid 455E1829-45D1-4485-8467-80A463DA5227
-ObjectGuid DA096D83-A07D-44F6-A0D2-35B88A10F6A5
Adds the object with the given Guid to the collection with the given Guid.
Synopsis
Adds a design class to the database.
Syntax
Add-MNEDesignClass [-DesignClassName] <string> -Authoritative <Boolean> -
DataStoreTypeMask <DataStoreTypeMaskEnum> [<CommonParameters>]
Description
Adds a design class to the database, per specified parameters.
Parameters
-DesignClassName <string>
Name of the design class to add.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Authoritative <Boolean>
Whether or not the design class to add has authoritative status.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DataStoreTypeMask <DataStoreTypeMaskEnum>
Data store type mask of the design class to add.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Outputs
NMEDesignClass
Design class that was added, if there are no errors.
Examples
PS C:\>Add-MNEDesignClass -DesignClassName "TestName" -Authoritative $true -
DataStoreTypeMask All
Adds a design class with the given parameters to the database.
Synopsis
Adds a group collection.
Syntax
Add-MNEGroupCollection [-Name] <string> [-Label <string>] [-Description <string>] [-
Query <string>] [-QueryType <NmeCollectionQueryType>] [-Disabled]
[<CommonParameters>]
Description
Adds a specified new group collection.
Parameters
-Name <string>
The name of the group collection to add.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
The label to add to the group collection.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
The description of the group collection to add.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
The query of the group collection to add.
Required: false
Position: Named
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
132
PowerShell cmdlets for Migrator for Notes to Exchange
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <NmeCollectionQueryType>
The query type of the group collection to add.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Disabled [<SwitchParameter>]
The collection should be disabled after adding.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Returns the collection that was added, if there are no errors.
Examples
PS C:\>Add-MNEGroupCollection -Name "GroupCollection" -Label "SampleGroup" -
Description "This is a test" -Query "This is a query"
Adds the group collection with the given values into the database.
Synopsis
Adds specified InetDomain to the database by specific name or an existing object.
Syntax
Add-MNEInetDomain [-DomainName] <string> [-Disabled] [-IsDefault]
[<CommonParameters>]
Description
Adds specified InetDomain to the database by specific name or an existing object.
By default, the domain is marked as active and does not change the default.
Parameters
-DomainName <string>
The name of the domain. Must have a period and only consist of Letters, Numbers, and Hyphens.
The cmdlet throws an error if domain is already present in database or have incorrect syntax.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-AsObject <InetDomain>
Create and add a new domain to database from existing object.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Disabled [<SwitchParameter>]
Sets the Domain to be disabled, not active.
Required: false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
134
PowerShell cmdlets for Migrator for Notes to Exchange
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IsDefault [<SwitchParameter>]
Sets domain to be the default domain. Changes all other domain defaults to be false.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
Add new domain by domain name from pipeline input.
InetDomain
Add new domain by InetDomain object from pipeline input.
Outputs
InetDomain
Returns the InetDomain object that was added to the database.
Examples
PS C:\>Add-MNEInetDomain "test.domain.com"
Adds the domain "test.domain.com" to the database. Enabled is "true". This domain is not the default.
Synopsis
Add the MNE admin user Full Access permission to mailboxes in the user collection for Office 365. If Admin
Account Pool is used, the Office365 admin role specified by the configuration will be used instead of the MNE
admin user.
Syntax
Add-MNEMailboxAdminPermission [-CollectionName] <string> [<CommonParameters>]
Description
Prior to migrating the Notes mail database to Office Online, you must grant the migration admin user Full Access
permission to the mailboxes in the user collection. This cmdlet takes the MNE user collection name and grants the
migration admin user Full Access to the mailboxes in the user collection. Use the cmdlet Remove-
MNEMailboxAdminPermission to remove the Full Access permission granted to the admin user once the migration
is complete.
Parameters
-CollectionName <string>
Name of the user collection containing the mailboxes where the Exchange admin user will be granted Full
Access
permission.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Name or Guid of the existing configuration to use.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFilename <string>
File name of a configuration settings .ini file to use as the configuration.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
136
PowerShell cmdlets for Migrator for Notes to Exchange
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
QuestSoftware.NME.PSModule.Utils.ManageMailboxPermissionResult
Returns a ManageMailboxPermissionResult object that contains information regarding the result of this
cmdlet.
Examples
PS C:\>Add-MNEMailboxAdminPermission "All Users"
Grants MNE admin user Full Access permission to mailboxes in the "All Users" collection using default
configuration setting and returns the results.
Synopsis
Adds a NotesDomain to the database using a domain name and type or NotesDomain object
Syntax
Add-MNENotesDomain [-DomainName] <string> [[-DomainType] <DomainTypeEnum>]
[<CommonParameters>]
Description
Parameters
-DomainName <string>
The name of the domain. Follows URI DNS syntax.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-DomainType <DomainTypeEnum>
The type of domain. The default type is None if not specified.
Required: false
Position: 1
Default value:"None"
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-AsObject <NotesDomain>
Add a NotesDomain from the properties of another NotesDomain object.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
138
PowerShell cmdlets for Migrator for Notes to Exchange
Inputs
string
The name of the domain. Follows URI DNS syntax.
DomainTypeEnum
The type of domain. The valid type are None, Domain, and GlobalDomain.
NotesDomain
Add a NotesDomain from the properties of another NotesDomain object.
Outputs
NotesDomain
Returns the NotesDomain object that was added to the database.
Examples
PS C:\>Add-MNENotesDomain "test.domain.com"
Adds the domain "test.domain.com" to the database. DomainType defaults to "None".
Synopsis
Adds the Nab specified by the given path. The Nab is either from a local file or from the domino server.
Syntax
Add-MNENotesNab [-FilePath] <string> [-NotesPassword <string>] [-Title <string>]
[<CommonParameters>]
Description
The Add-MNENotesNab cmdlet add the Nab (Notes Address Book) that is given by the filepath.
The title is automatically added from the Nab if not specified by the user.
Displays warnings if the path is not found, it is of the incorrect file type, or the NAB already exists in the database.
Parameters
-FilePath <string>
The location of the Notes Address Book to add. The path may be a local path or a path to the Notes Server
formatted as it is in the NME program.
The cmdlet confirms whether the file is the correct extension, whether the FilePath already exists in the
database, and whether the FilePath is valid.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByPropertyName)
Accept wildcard characters:false
-NotesPassword <string>
The password for the Domino server if needed. Must have ID file already selected for Notes.
Required: false
Position: Named
Default value:
Accept pipeline input:true (ByPropertyName)
Accept wildcard characters:false
-Title <string>
Allows the user to specify a title for the NAB.
Required: false
Position: Named
Default value:
Accept pipeline input:true (ByPropertyName)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
This cmdlet accepts FilePath, NotesPassword, Title from pipeline input.
Outputs
This cmdlet either returns a warning if incorrect or returns nothing and simply adds the NAB to the SQL
database.
Examples
PS C:\>Add-MNENotesNab -Filepath "C:\Example.nsf" -Title "Test"
Retrieves the NAB located at "C:\Example.nsf" from the local files. Sets the title as "Test".
Synopsis
Adds a user collection.
Syntax
Add-MNEUserCollection [-Name] <string> [-Label <string>] [-Description <string>] [-
Query <string>] [-QueryType <NmeCollectionQueryType>] [-Disabled]
[<CommonParameters>]
Description
Adds a specified new user collection.
Parameters
-Name <string>
The name of the user collection to add.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
The label of the user collection to add.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
The description of the user collection to add.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
The query of the user collection to add.
Required: false
Position: Named
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
142
PowerShell cmdlets for Migrator for Notes to Exchange
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <NmeCollectionQueryType>
The query type of the user collection to add.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Disabled [<SwitchParameter>]
The collection should be disabled after adding.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Outputs the collection that was added, if there are no errors.
Examples
PS C:\>Add-MNEUserCollection -Name "UserCollection" -Label "SampleGroup" -
Description "This is a test" -Query "This is a query"
Adds the user collection with the given values into the database.
Synopsis
Adds a new workstation to the database.
Syntax
Add-MNEWorkstation -WorkstationName <string> -TcpipAddress <string>
[<CommonParameters>]
Description
Adds a new workstation to the SQL database with the given workstation name and TCP/IP address.
Parameters
-WorkstationName <string>
Name of the workstation to add.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByPropertyName)
Accept wildcard characters:false
-TcpipAddress <string>
TCPaddress of the workstation to add.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByPropertyName)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
Both the WorkstationName and TCPIPAddress parameters accept pipeline input by property value.
Outputs
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
144
PowerShell cmdlets for Migrator for Notes to Exchange
QuestSoftware.NMEAPI.Controllers.Workstation
Returns the workstation that was added to the database.
Examples
PS C:\>Add-MNEWorkstation -WorkstationName "MyComputer" -TCPIPAddress
"000.000.00.000"
Add the workstation to the database with name "MyComputer" and IP address "000.000.00.000"
Synopsis
Converts a configuration between a Task and Template Config.
Syntax
Convert-MNEConfiguration [-ConfigurationFromPipeline] <NMEConfiguration> -
ConvertToTask [<CommonParameters>]
Description
Converts a configuration from a task to a template or vise versa, then saves it to the database.
Parameters
-ConfigurationFromPipeline <NMEConfiguration>
Configuration to convert.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ConvertToTask [<SwitchParameter>]
Convert the Configuration to a Task Config.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConvertToTemplate [<SwitchParameter>]
Convert the Configuration to a Template Config.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TemplateType <TemplateTypeEnum>
Convert the Template Configuration to Full Template or Differential Template. If the configuration is already a
Template configuration, no conversion will be done if the TemplateType parameter is not specified.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
146
PowerShell cmdlets for Migrator for Notes to Exchange
Required: false
Position: Named
Default value:.Full
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
Configuration
The Configuration parameter accepts pipeline input.
Outputs
Configuration
Returns the converted configuration.
Examples
PS C:\>$config | Convert-MNEConfiguration -ConvertToTemplate
Synopsis
Copies a group collection.
Syntax
Copy-MNEGroupCollection [-CollectionName] <string> [-Name] <string> [-Label
<string>] [-Description <string>] [-Query <string>] [-QueryType
<NmeCollectionQueryType>] [<CommonParameters>]
Description
This cmdlet copies a specified group collection.
Parameters
-CollectionName <string>
Name of the group collection to copy.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Name <string>
Name of the group collection to copy to.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
Label of the group collection to copy to.
If not specified, the label of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
Description of the group collection to copy to.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
Query of the group collection to copy to.
If not specified, the query of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <NmeCollectionQueryType>
Query type of the group collection to copy to.
If not specified, the query type of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Returns the collection that was copied to, if there are no errors.
Examples
PS C:\>Copy-MNEGroupCollection -CollectionName "OriginalCollection" -Name
"GroupCollection" -Label "SampleGroup" -Description "This is a test" -Query "This
is a query"
Copies the group collection with the given values into the database.
Synopsis
Copies a user collection.
Syntax
Copy-MNEUserCollection [-CollectionName] <string> [-Name] <string> [-Label <string>]
[-Description <string>] [-Query <string>] [-QueryType <NmeCollectionQueryType>]
[<CommonParameters>]
Description
Copies a specified user collection.
Parameters
-CollectionName <string>
Name of the user collection to copy.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Name <string>
Name of the user collection to copy to.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
Label of the user collection to copy to.
If not specified, the label of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
Description of the user collection to copy to.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
Query of the user collection to copy to.
If not specified, the query of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <NmeCollectionQueryType>
Query type of the user collection to copy to.
If not specified, the query type of the copy collection is set to that of the original.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Outputs the collection that was copied to, if there are no errors.
Examples
PS C:\>Copy-MNEUserCollection -CollectionName "OriginalCollection" -Name
"UserCollection" -Label "SampleGroup" -Description "This is a test" -Query "This is
a query"
Copies the user collection with the given values into the database.
Synopsis
Exports collections of a specific type to a .tsv file.
Syntax
Export-MNECollections [-Path] <string> [-CollectionType] <CollectionTypeEnum> [-
Autodefined <Boolean>] [-LogFile <string>] [<CommonParameters>]
Description
This cmdlet exports the collections of a specific type to a file specified by the user.
Parameters
-Path <string>
The file to export the group collection to.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-CollectionType <CollectionTypeEnum>
The type of collection to export. Valid collection types are None, User, Group or Scheduling.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Autodefined <Boolean>
Include autodefined collections
Required: false
Position: Named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-LogFile <string>
Location of the Logfile to create/append to.
Required: false
Position: Named
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
154
PowerShell cmdlets for Migrator for Notes to Exchange
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
The file to export the group collection to.
Boolean
Include autodefined collections.
Outputs
PSObject
Returns the stats of the export.
Examples
PS C:\>Export-MNECollections -Path "C:\Path.tsv" -CollectionType Group
Exports the group collections to the file at "C:\Path.tsv".
Synopsis
Export a configuration to a file.
Syntax
Export-MNEConfiguration [-ConfigurationGuid] <Guid> [[-FileName] <string>] [-Force]
[-RawConfiguration] [<CommonParameters>]
Description
Exports a configuration to the specified file.
Updates the file with the configuration represented by the configuration Guid.
Parameters
-ConfigurationGuid <Guid>
Guid of the configuration to export to the file.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-FileName <string>
File to export the configuration to.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Force [<SwitchParameter>]
Overwrite an existing file without prompting the user for confirmation.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RawConfiguration [<SwitchParameter>]
Export configuration settings from database without merging with default settings.
Required: false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
156
PowerShell cmdlets for Migrator for Notes to Exchange
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
Configuration Guid accepts input from the pipeline.
Outputs
This cmdlet returns the directory path of the exported file upon a successful run.
Examples
PS C:\>Export-MNEConfiguration -ConfigurationGuid 69F764C9-D209-4C4D-BCCB-
6E59F615CD9D -FileName "TestName"
Exports the configuration from the specified Guid to the file named "TestName" with the default file extension ".ini"
in the current directory.
Synopsis
Export configuration data to a file.
Syntax
Export-MNEConfigurationData [-ConfigurationData] <ConfigurationData> [[-FileName]
<string>] [-Force] [<CommonParameters>]
Description
Exports configuration data to the specified file.
Parameters
-ConfigurationData <ConfigurationData>
Configuration data to export to the file.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-FileName <string>
File to export the configuration data to.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Force [<SwitchParameter>]
Overwrite an existing file without prompting the user for confirmation.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
158
PowerShell cmdlets for Migrator for Notes to Exchange
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
ConfigurationData
The ConfigurationData parameter accepts input from the pipeline.
Outputs
This cmdlet returns the directory path of the exported file upon a successful run.
Examples
PS C:\>Export-MNEConfigurationData -ConfigurationData $data -FileName "TestName"
Exports the configuration data object to the specified file with the default file extension ".ini" in the current directory.
Synopsis
Exports data from the specified summary to the designated tsv (tab-delimited file).
Syntax
Export-MNESummary [-FilePath] <string> [-Summary] <ViewSummary> [<CommonParameters>]
Description
Exports data from the specified summary to the designated tsv (tab-delimited file).
The path specified will automatically overwrite any existing file.
Parameters
-FilePath <string>
The designated export location and filename for the summary.
The cmdlet will confirm if the file is the correct extension and overwrite any existing file.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Summary <ViewSummary>
The chosen summary to be exported.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Outputs
This cmdlet returns no values on a successful run.
Examples
PS C:\>Export-MNESummary -Filepath "C:\summary.tsv" -Summary UserAndResources
Exports the user and resurces summary to a tsv file called "summary" in the root of the c drive.
Synopsis
Removes certain lines in the NME Database Export that are expected to change.
For this cmdlet to work properly, the export must be exported with high width, so that the file was not cut off by the
window size.
Syntax
Format-MNEDatabaseExport -InputFile <string> [-IgnoreFile <string>]
[<CommonParameters>]
Description
Parameters
-InputFile <string>
File that will be formatted.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IgnoreFile <string>
Path to a file containing all the lines of text to ignore in it.
If not specified, the text to ignore will default to "ComputerName :", "TcpipAddress :", "LogDir=",
"EndUserDir=", "SMTPTranslationTable=", "CentralLogDir=", "~AdminPassword=", "UserIdFile=", "~Password=",
"LastProvisionUserCollectionsCollection=", "LastLocateNotesDataStoresCollection=", "ATGenerated=",
"LastManageUserCollectionsLabel=", "LastManageGroupsLabel=", "LastProvisionUserCollectionsLabel=",
"LastSendPabReplicatorLabel=", "LastSendPabReplicatorCollection=", "DefaultAdminIniStatus=",
"DefaultDesktopIniStatus=", "LastProvisionGroupsLabel=", "LastProvisionGroupsCollection=",
"LastLocateNotesDataStoresLabel=", "LastMigrateUserDataLabel=", "LastMigrateUserDataCollection=".
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Outputs
System.String
Returns the formatted output.
Examples
PS C:\>Format-MNEDatabaseExport -InputFile C:\exampleexport.txt
Formats the database export at C:\exampleexport.txt using the default ignore lines and outputs it to the console.
Synopsis
Formats a group collection.
Syntax
Format-MNEGroupCollection [-CollectionName] <string> [-Name <string>] [-Label
<string>] [-Description <string>] [-Query <string>] [-QueryType
<NmeCollectionQueryType>] [<CommonParameters>]
Description
Formats the indicated group collection with the values of the other parameters.
Parameters
-CollectionName <string>
Name of the group collection to format.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Name <string>
Name to change the group collection name to.
If not specified, the name of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
Label to change the group collection label to.
If not specified, the label of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
164
PowerShell cmdlets for Migrator for Notes to Exchange
Description to change the group collection description to.
If not specified, the description of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
Query to change the group collection query to.
If not specified, the query of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <string>
Query type to change the group collection query to.
If not specified, the query type of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Outputs the collection that was updated to, if there are no errors.
Examples
PS C:\>Format-MNEGroupCollection -CollectionName "OriginalCollection" -Name
"GroupCollection" -Label "SampleGroup" -Description "This is a test" -Query "This
is a query"
Synopsis
Formats a user collection.
Syntax
Format-MNEUserCollection [-CollectionName] <string> [-Name <string>] [-Label
<string>] [-Description <string>] [-Query <string>] [-QueryType
<NmeCollectionQueryType>] [<CommonParameters>]
Description
This cmdlet formats the indicated user collection with the values of the other parameters.
Parameters
-CollectionName <string>
Name of the user collection to format.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Name <string>
Name to change the user collection name to.
If not specified, the name of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Label <string>
Label to change the user collection label to.
If not specified, the label of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Description <string>
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
167
PowerShell cmdlets for Migrator for Notes to Exchange
Description to change the user collection description to.
If not specified, the description of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Query <string>
Query to change the user collection query to.
If not specified, the query of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QueryType <NmeCollectionQueryType>
Query type to change the user collection query to.
If not specified, the query type of the collection will remain the same.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Collection
Outputs the collection that was updated to, if there are no errors.
Examples
PS C:\>Format-MNEUserCollection -CollectionName "OriginalCollection" -Name
"GroupCollection" -Label "SampleGroup" -Description "This is a test" -Query "This
is a query"
Synopsis
Returns the user settings obtained from the Plain Old XML (POX) Autodiscover service.
Syntax
Get-MNEAutodiscoverUserSettings [-UserSmtpAddress] <string> [-AutodiscoverUrl
<string>] [-Credential <PSCredential>] [-WebProxyCredential <PSCredential>] [-
AllowSelfSignedCertificates] [-EnableScpLookup] [-DisableMapiHttp] [-MaxHops
<Integer>] [<CommonParameters>]
Description
Returns the user settings obtained from the Plain Old XML (POX) Autodiscover service.
Parameters
-UserSmtpAddress <string>
Specifies the user SMTP address used to perform autodiscover.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-AutodiscoverUrl <string>
Specifies the Autodiscover Url endpoint.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Credential <PSCredential>
Specifies the credentials that are used to authenticate with the Autodiscover service.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WebProxyCredential <PSCredential>
Specifies the HTTP proxy credential settings.
Required: false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
170
PowerShell cmdlets for Migrator for Notes to Exchange
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AllowSelfSignedCertificates [<SwitchParameter>]
Validate the certificate for the server responding to the Autodiscover request. By default only certificates
signed by a trusted root authority are considered valid. Self-signed certificates are only considered valid if this is
set to True.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EnableScpLookup [<SwitchParameter>]
Indicates whether MNE should perform a service connection point (SCP) lookup when it is determining the
service URL.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DisableMapiHttp [<SwitchParameter>]
Determines whether or not MNE requests MAPI/HTTP protocol information from the Autodiscover service.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxHops <Integer>
Specifies the value for maximum number of redirects or hops when performing autodiscover. The default value
is
10.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
171
PowerShell cmdlets for Migrator for Notes to Exchange
The UserSmtpAddress parameter accepts values from the pipeline.
Outputs
QuestSoftware.EwsMe.IPoxUserSettings
Returns user settings from the Plain old XML (POX) Autodiscover service response.
Examples
PS C:\>Get-MNEAutodiscoverUserSettings -UserSmtpAddress test@domain.com
Returns user settings such as UserDisplayName, UserDN, ExternalMailboxServer, etc. from the Autodiscover
service response.
Synopsis
Gets all of the collections or the indicated collection from the database.
Syntax
Get-MNECollection [-CollectionType <NmeCollectionType>] [<CommonParameters>]
Description
This cmdlet returns either all collections in the database, or the collection for the specified GUID.
Parameters
-CollectionType <NmeCollectionType>
The collection type to search for. The default type is User.
Required: false
Position: named
Default value:.User
Accept pipeline input:false
Accept wildcard characters:false
-CollectionGuid <Guid>
Guid of the collection to get from the database.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
Guid
The CollectionGuid parameter accepts input from the pipeline.
Examples
PS C:\>Get-MNECollection -CollectionGuid 455E1829-45D1-4485-8467-80A463DA5227
Returns the user or group collection associated with the given Guid.
PS C:\>Get-MNECollection
Returns all user collections in the database.
Synopsis
Returns all members in a collection.
Syntax
Get-MNECollectionMember [-CollectionGuid] <Guid> [<CommonParameters>]
Description
Returns all members in a collection that is specified by the Guid given by the user.
Parameters
-CollectionGuid <Guid>
Guid of collection to retrieve the collection members from.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
The CollectionGuid parameter accepts values from the pipeline.
Outputs
CollectionMember
Returns all members of the given collection.
Examples
PS C:\>Get-MNECollectionMember -CollectionGuid 69F764C9-D209-4C4D-BCCB-6E59F615CD9D
Returns all members in the collection with the specified Guid.
Synopsis
Returns either a single or multiple configurations.
Syntax
Get-MNEConfiguration [[-ConfigurationGuid] <Guid>] [-RawConfiguration
<SwitchParameter>] [<CommonParameters>]
Description
Returns either a single or multiple configurations based on the user input.
The inputs are given priority, with GUID being the highest, then name and configuration type enum (Optional),
then configuration type enum, then none.
Giving a GUID returns a single configuration with that Guid. Name and configuration type enum (Optional) returns
a single configuration with that name. The enum returns all configurations of that type. None returns all
configurations in the database.
Parameters
-ConfigurationGuid <Guid>
Can be used to retrieve the configuration of the specified Guid.
Required: false
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Name <string>
Can be used to retrieve the configuration of the specified name.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ConfigurationType <ConfigurationTypeEnum>
Can be used to retrieve the configuration of the specified name and the specified type based on the
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
176
PowerShell cmdlets for Migrator for Notes to Exchange
ConfigurationTypeEnum.
Can be used to retrieve all configurations of the specified type based on the ConfigurationTypeEnum.
The valid configuration types are Default, DiscoverNabs, DiscoverDomains, DirExport, MergeContacts,
DiscoverData, ProvisionGroups, SendPabReplicator, MigrateWithSSDM, MigrateWithAdmin and
GatherUserStats.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RawConfiguration [<SwitchParameter>]
Get raw configuration settings without merging with default settings.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.String
The Name of the configuration to retrieve.
System.Guid
The Guid of the configuration to retrieve.
Outputs
Configuration
Returns either a single or multiple configurations based on the user given input.
Examples
PS C:\>Get-MNEConfiguration -ConfigurationGuid 69F764C9-D209-4C4D-BCCB-6E59F615CD9D
Returns the configuration with the specified Guid.
PS C:\>Get-MNEConfiguration
Returns all configurations in the database.
Synopsis
Gets the database connection string for the SQL database.
Syntax
Get-MNEDatabaseConnectionString [<CommonParameters>]
Description
Builds the connection string using SqlConnectionStringBuilder.
Then writes the connection after getting the connection string from the NME database connection.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet does not have any parameters that accept pipeline input.
Outputs
System.Data.SqlClient.SqlConnectionStringBuilder
Returns the database connection string object.
Examples
PS C:\>Get-MNEDatabaseConnectionString
Retrieves the connection to the SQL database for Notes Migrator for Exchange.
Synopsis
Accesses the NME Database and exports it.
Syntax
Get-MNEDatabaseExport [<CommonParameters>]
Description
Accesses the NME Database and exports it to console output.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
System.String
Outputs the full NME database. Quest recommendeds you to output this to a file.
Examples
PS C:\>Get-MNEDatabaseExport
Exports the NME Database directly to the console.
Synopsis
Gets the database version.
Syntax
Get-MNEDatabaseVersion [<CommonParameters>]
Description
This cmdlet returns the database version.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Version
Returns the current database version.
Examples
PS C:\>Get-MNEDatabaseVersion
Returns the current database version.
Syntax
Get-MNEGlobalDefaultSettings [<CommonParameters>]
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
None
Outputs
System.ObjectALIASES
NoneREMARKS
None
Synopsis
Gets the currently installed license information from MNE.
Syntax
Get-MNELicense [<CommonParameters>]
Description
Gets the currently installed license information from MNE.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
LicenseInfo
PSObject that contains license Type, ExpirationDate, Status, IsValid, Number, MigratedUsers, and
SeatsUsed.
Examples
Synopsis
Returns all relevant data from the migration for the specified objects. You can input an SMTP address, object
Guid, or collection Guid to get the information.
Syntax
Get-MNEMigrationResult [-SmtpAddress] <string> [<CommonParameters>]
Description
This cmdlet returns all relevant data from the migration for the specfied objects. You can input an SMTP address,
object Guid, or collection Guid to get the information.
Parameters
-SmtpAddress <string>
The SMTP address of the object to check the migration results for.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ObjectGuid <Guid>
The Guid of the object to check the migration results for.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CollectionGuid <Guid>
The Guid of the collection to check the migration results for.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
184
PowerShell cmdlets for Migrator for Notes to Exchange
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.String
The cmdlet parameter SmtpAddress accepts input from the pipeline.
Outputs
MigrationUserResult, MigrationResourceResult
Returns all relevant data from the migration for the specified objects.
Examples
PS C:\>Get-MNEMigrationResult -SmtpAddress sample@test.nme.com
Returns the migration information for the user(s) or resource(s) with the given smtp address.
Synopsis
Gets either a single migration task (by task Guid) or multiple tasks (by Configuration type enum).
Syntax
Get-MNEMigrationTask -TaskGuid <Guid> [<CommonParameters>]
Description
Gets either a single migration task (by task Guid) or multiple tasks (by Configuration type enum).
Parameters
-TaskGuid <Guid>
Guid of the migration task to retrieve.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationType <ConfigurationTypeEnum>
Configuration type of the migration task(s) to retrieve.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept input from pipeline.
Outputs
Task
Examples
PS C:\>Get-MNEMigrationTask -TaskGuid 555B8BB5-7AE0-4CBF-A7FF-9B11163CD9B1
Returns the migration task with the given Guid.
Synopsis
Gets the migration time window.
Syntax
Get-MNEMigrationTimeWindow [[-CollectionName] <string>] [<CommonParameters>]
Description
Gets the migration time window.
Returns the migration schedule for a given collection if the collection name is specified or for all scheduled
collections.
Parameters
-CollectionName <string>
Name of the collection to retrieve the schedule for if specfied.
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept input from pipeline.
Outputs
SingleCollectionSchedule
Returns the schedule for a given collection if the collection name is specified.
Examples
PS C:\>Get-MNEMigrationTimeWindow -CollectionName "Test"
Returns the migration time information for the collection named "Test".
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
188
PowerShell cmdlets for Migrator for Notes to Exchange
PS C:\>Get-MNEMigrationTimeWindow
Returns the migration time information for all scheduled collections.
Synopsis
Gets the specified resource.
Syntax
Get-MNEResource [-SmtpEmailAddress] <string> [<CommonParameters>]
Description
This cmdlet returns the specified mail-in database or resource based on the specified smtp address or object
Guid.
Parameters
-SmtpEmailAddress <string>
SMTP address of the resource to retrieve.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ObjectGuid <Guid>
Guid of the object associated with the resource to retrieve.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.String
SMTP address of the resource to retrieve.
System.Guid
Outputs
Resource
Returns the specified resource information (either by SMTP address or object Guid).
Examples
PS C:\>Get-MNEResource -SmtpEmailAddress sample@test.nme.com
Returns the resource associated with the given smtp address.
Synopsis
Gets the list of scheduling configuration files and returns them.
Syntax
Get-MNESchedulingConfigFile [<CommonParameters>]
Description
Gets the list of scheduling configuration files and returns them.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
ConfigNames
Returns the names of the scheduling config files.
Examples
PS C:\>Get-MNESchedulingConfigFile
Gets and returns the names of the configuration files for the SSDM Scheduling Administration tool.
Synopsis
Gets and returns the list of global scheduling settings for the SSDM Scheduling Administration tool.
Syntax
Get-MNESchedulingSetting [<CommonParameters>]
Description
Gets the list of global scheduling settings for the SSDM Scheduling Administration tool and returns them.
Parameters
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
SchedulingGlobalSettings
Return the global settings for scheduling in SSDM Scheduling Administration tool.
Examples
PS C:\>Get-MNESchedulingSetting
Gets and returns the list of global scheduling settings for the SSDM Scheduling Administration tool.
Synopsis
Gets the Task Errors for a specified given task or run.
Syntax
Get-MNETaskError [-TaskRunGuid] <Guid> [<CommonParameters>]
Description
This cmdlet outputs the errors for a specified task and/or task run.
Parameters
-TaskRunGuid <Guid>
Guid of the task run to retrieve the errors from if retrieving by task run.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-TaskGuid <Guid>
Guid of the task to retrieve the errors from if retrieving by task.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
Guid
Guid of the task run to retrieve the errors from.
Examples
PS C:\>Get-MNETaskError -TaskGuid 555B8BB5-7AE0-4CBF-A7FF-9B11163CD9B1
Returns the task error information for the specified task.
Synopsis
Gets the specified task run.
Syntax
Get-MNETaskRun [-TaskRunGuid] <Guid> [<CommonParameters>]
Description
This cmdlet retrieves information for a specified task run.
Parameters
-TaskRunGuid <Guid>
Guid of a task run, if looking for a task run by its own Guid.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-TaskName <string>
Task Name, if finding all task runs associated with a particular task.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-TaskGuid <Guid>
Guid of the task, if finding the task runs associated with that task.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
Guid of a task run, if looking for a task run by its own Guid.
System.String
Task Name, if finding all task runs associated with a particular task.
Outputs
TaskRun
Outputs information on the specified task run.
Examples
PS C:\>Get-MNETaskRun -TaskGuid 555B8BB5-7AE0-4CBF-A7FF-9B11163CD9B1
Returns the task run associated with the task with the given Guid.
Synopsis
Gets the specified task schedule.
Syntax
Get-MNETaskSchedule [-TaskGuid <Guid>] [<CommonParameters>]
Description
Retrieves information for a specific task schedule.
Using verbose will output the name and Guid prior to the schedule.
Parameters
-TaskGuid <Guid>
Guid of the task specified to get the schedule for.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Schedule
Returns the schedule of the specified task, or the schedules of all scheduled tasks.
Examples
PS C:\>Get-MNETaskSchedule -TaskGuid 555B8BB5-7AE0-4CBF-A7FF-9B11163CD9B1
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
198
PowerShell cmdlets for Migrator for Notes to Exchange
Returns the task schedule associated with specified task Guid.
PS C:\>Get-MNETaskSchedule
Returns all schedules of scheduled tasks.
Synopsis
Gets the specified user.
Syntax
Get-MNEUser [[-SmtpEmailAddress] <string>] [<CommonParameters>]
Description
This cmdlet returns the specified user based on the defined smtp address or object Guid.
Parameters
-SmtpEmailAddress <string>
SMTP address of the user to retrieve.
Required: false
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ObjectGuid <Guid>
Guid of the object associated with the user to retrieve.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.String
SMTP address of the user to retrieve.
System.Guid
Guid of the object associated with the user to retrieve.
Examples
PS C:\>Get-MNEUser -SmtpEmailAddress sample@test.nme.com
Returns the user associated with the given smtp address.
Synopsis
Gets the workstation specified or all workstations.
Syntax
Get-MNEWorkstation [-WorkstationGuid <Guid>] [<CommonParameters>]
Description
This cmdlet returns the workstation specified by the given Guid or all workstation if no Guid is given.
Parameters
-WorkstationGuid <Guid>
Guid of the workstation to retrieve.
Required: false
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
WorkstationGuid parameter accepts pipeline input.
Outputs
Workstation
Outputs the workstation specified by user, or all workstations if no Guid is given.
Examples
PS C:\>Get-MNEWorkstation -WorkstationGuid 69F764C9-D209-4C4D-BCCB-6E59F615CD9D
Returns the workstation with the specified Guid.
PS C:\>Get-MNEWorkstation
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
202
PowerShell cmdlets for Migrator for Notes to Exchange
Returns all workstations in the database.
Synopsis
Sets a Collection to be "invisible" in the UI.
Syntax
Hide-MNECollection [-Collection] <NmeCollection> [<CommonParameters>]
Description
Sets a Collection to be "invisible" in the UI. The collection is added/updated in the database upon completion.
Collections that are "invisible" are essentially disabled and will not be included during migrations.
Parameters
-Collection <NmeCollection>
The collection object to be hidden.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
NmeCollection
The Collection parameter accepts object input from the pipeline.
Outputs
None if successful
Examples
Get-MNECollection -CollectionGuid "e50d5123-2ec8-4096-816e-8e0e458d12e7" | Hide-
MNECollection
A collection is retrieved from the database and its visiblity is set to hidden.
Synopsis
Import collections of any kind from a specified file.
Syntax
Import-MNECollections [-Path] <string> [-LogFile <string>] [<CommonParameters>]
Description
Import collections of any kind from a specified file.
Parameters
-Path <string>
Path to the file from which the collections will be imported.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-LogFile <string>
Path to which the log will be written.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
This cmdlet accepts file path input from the pipeline.
Outputs
PSObject
Examples
PS C:\>Import-MNECollections -Path "C:\Collections.tsv"
Imports the collections from the file at "C:\Collections.tsv".
Synopsis
Import a configuration from file.
Syntax
Import-MNEConfiguration [-ConfigurationGuid] <Guid> [-FileName] <string> [-
RawConfiguration] [<CommonParameters>]
Description
Imports configurations from the given file.
Updates the configuration represented from the configuration Guid with the settings from the file.
Parameters
-ConfigurationGuid <Guid>
Guid of the configuration to which the settings from the file will be imported.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-FileName <string>
The name of the file that has the configuration settings to import.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RawConfiguration [<SwitchParameter>]
Import configuration settings from file without comparing with default settings.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
207
PowerShell cmdlets for Migrator for Notes to Exchange
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
The ConfigurationGuid parameter accepts input from the pipeline.
Outputs
This cmdlet returns no values upon a successful run.
Examples
PS C:\>Import-MNEConfiguration -ConfigurationGuid 69F764C9-D209-4C4D-BCCB-
6E59F615CD9D -FileName "TestName"
Imports the configuration from the file named "TestName" and updates the configuration with the given Guid with
those settings.
Synopsis
Import configuration data from file.
Syntax
Import-MNEConfigurationData [-FileName] <string> [<CommonParameters>]
Description
Imports configuration data from the given file.
Parameters
-FileName <string>
Name of the file to import the configuration data from.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
ConfigurationData
Returns the configuration data from the file.
Examples
PS C:\>Import-MNEConfigurationData -FileName "TestName"
Imports the configuration data from the file named "TestName".
Synopsis
Preprovision mailbox user's OneDrive store in the user collection for Office 365. It is required for the user's
OneDrive store to be ready if the feature for MNE to migrate oversized attachments to OneDrive is enabled..
Syntax
Initialize-MNEOneDriveUserCollection [-CollectionName] <string> [<CommonParameters>]
Description
Prior to migrating the Notes mail database to Office Online, if you enable oversized attachments migration to
OneDrive store, all users in the user collection should have their OneDrive stores provisioned. This cmdlet takes
the MNE user collection name and initializes OneDrive store for each user in the user collection.
Parameters
-CollectionName <string>
Name of the user collection containing the mailbox users that have licensed OneDrive store to be
preprovisioned by the Exchange admin user.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Name or Guid of the existing configuration to use.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFilename <string>
File name of a configuration settings .ini file to use as the configuration.
Required: true
Position: Named
Default value:
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
None if successful.
Examples
PS C:\>Initialize-MNEOneDriveUserCollection "All Users"
Preprovision OneDrive store for all mailbox users in the "All Users" collection using default configuration setting.
Synopsis
Installs a license file for MNE using the given file path.
Syntax
Install-MNELicense [-Path] <string> [<CommonParameters>]
Description
Installs a license file for MNE using the given file path.
Parameters
-Path <string>
File path for the license to install.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
LicenseInfo
PSObject that contains license Type, ExpirationDate, Status, IsValid, Number, MigratedUsers, and
SeatsUsed.
Examples
Synopsis
Exports the Directory Exporter objects in MNE to a tsv file.
Syntax
Invoke-MNEExportObjectsToTsv [-TsvFilePath] <string> [<CommonParameters>]
Description
Exports the directory exporter objects in NME to a tsv file.
Parameters
-TsvFilePath <string>
The UNC path of the tsv file to export to.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
This cmdlet accepts file path input from the pipeline.
Outputs
Nothing is returned from this cmdlet.
Examples
PS C:\>Invoke-MNEExportObjectsToTsv -TsvFilePath "C:\exampletsv.tsv"
Exports all objects to the tsv specified if it exists, otherwise creates a new tsv file.
Synopsis
Runs the Enumerate Notes Domains executable with the configuration in the database or user-defined values.
Syntax
Invoke-MNEFindNotesDomain [[-DominoServer] <string>] [[-UserIdFile] <string>] [[-
Password] <string>] [-WorkStation <WorkStation>] [-LogFile <string>]
[<CommonParameters>]
Description
Runs the get notes domains executable with the configuration in the database or user defined values.
Parameters
-DominoServer <string>
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserIdFile <string>
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Password <string>
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEFindNotesDomain
Runs the NME Enumerate Notes Domain task and returns the process results.
Synopsis
Runs the Enumerate Notes NABs executable with the configuration in the database or user-defined values.
Syntax
Invoke-MNEFindNotesNab [[-DominoServer] <string>] [[-UserIdFile] <string>] [[-
Password] <string>] [-WorkStation <WorkStation>] [-LogFile <string>]
[<CommonParameters>]
Description
Runs the Enumerate Notes NABs executable with the configuration in the database or user-defined values.
Parameters
-DominoServer <string>
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserIdFile <string>
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Password <string>
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation this task should be ran on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEFindNotesNab
Runs the NME Enumerate Notes Nabs task and returns the process results.
Synopsis
Runs the Gather Desktop Statistics executable with the configuration in the database or user-defined values.
Syntax
Invoke-MNEGatherDesktopStatistics [[-StatisticsDirectory] <string>] [-WorkStation
<WorkStation>] [-LogFile <string>] [<CommonParameters>]
Description
Runs the Gather Desktop Statistics executable with the configuration in the database or user-defined values.
Parameters
-StatisticsDirectory <string>
The UNC path of the directory containing the SSDM statistics.
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
The full path of the file the application should log to. If no path is provided, log files will be created in the Log
Directory as defined in the default NME configuration.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEGatherDesktopStatistics
Runs the NME Gather Desktop Statistics enumerable.
Synopsis
Imports the Directory Exporter objects from a tsv file.
Syntax
Invoke-MNEImportObjectsFromTsv [-TsvFilePath] <string> [<CommonParameters>]
Description
Imports the directory exporter objects from a tsv file.
Parameters
-TsvFilePath <string>
UNC path of the tsv file from which to import.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
string
This cmdlet accepts file path input from the pipeline.
Outputs
Returns done or job failed status at the end of the run.
Examples
PS C:\>Invoke-MNEImportObjectsFromTsv -TsvFilePath "C:\exampletsv.tsv"
Imports all objects from the tsv file.
Synopsis
Runs the Enumerate Data executable with the configuration in the database or user-defined values.
Syntax
Invoke-MNELocateNotesDataStore [-UserCollection] <string> [[-UserIdFile] <string>]
[[-Password] <string>] -ConfigurationId <string> [-WorkStation <WorkStation>] [-
LogFile <string>] [<CommonParameters>]
Description
Scans the Notes environment for all data stores associated with a designated user collection.
Parameters
-UserCollection <string>
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserIdFile <string>
Required: false
Position: 1
Default value:in default settings
Accept pipeline input:false
Accept wildcard characters:false
-Password <string>
Required: false
Position: 2
Default value:in default settings
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Required: false
-LocateNew <NotesUpdateModeTypeEnum>
Required: false
Position: Named
Default value:.Append
Accept pipeline input:false
Accept wildcard characters:false
-LocateMailFiles <LocateDatastoresFindByEnum>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LocatePabs <LocateDatastoresFindByEnum>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LocateArchives <LocateDatastoresFindByEnum>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailFileDir <string>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabDir <string>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicaServer <string>
Required: false
Position: Named
Default value:in default config
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveDir <string>
-ArchiveReplicaServer <string>
Required: false
Position: Named
Default value:in default config
Accept pipeline input:false
Accept wildcard characters:false
-AclIgnoreList <string>
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-OwnerByAcl [<SwitchParameter>]
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
The full path of the file the application should log to. If no path is provided, log files will be created in the Log
Directory as defined in the default MNE configuration.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
223
PowerShell cmdlets for Migrator for Notes to Exchange
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNELocateNotesDataStore "All Users" -ConfigurationId "8846d710-03df-
4c51-ab51-4fe738526a78"
Creates and runs the NME Locate Notes Datastores Task and returns the process results on collection "All Users"
with settings from Configuration with guid "8846d710-03df-4c51-ab51-4fe738526a78".
Synopsis
Runs the Migrate User Data application with a specified configuration.
Syntax
Invoke-MNEMigrateUserData [-UserCollectionId] <string> -ConfigurationId <string> [-
MaxMigrationThreads <Integer>] [-WorkStation <WorkStation>] [-LogFile <string>] [-
ShowProgressDialog] [-ProgressDialogIsTopmost] [-ManuallyCloseProgressDialog]
[<CommonParameters>]
Description
Runs the Migrate User Data application with a specified configuration.
Parameters
-UserCollectionId <string>
Name or GUID of the user collection to migrate data from.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Name or Guid of the existing configuration to use for this migration.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFilename <string>
Filename of a configuration settings .ini file to use as the configuration for this migration.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
225
PowerShell cmdlets for Migrator for Notes to Exchange
-RawConfiguration [<SwitchParameter>]
Switch parameter that, if used with FileName, means this is a differential file and will save it to database as
differential file.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxMigrationThreads <Integer>
Maximum amount of migration threads to run at once.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
File to log the results to. If specified, this is used, otherwise a default value is used.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ShowProgressDialog [<SwitchParameter>]
Switch parameter that, if used, will display the task progress along with key migration statistics within a pop-up
dialog.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ProgressDialogIsTopmost [<SwitchParameter>]
Switch parameter that, when used with the ShowProgressDialog parameter, will cause the progress dialog to
be displayed on top of all other windows that are not topmost windows.
Required: false
Position: named
Default value:
-ManuallyCloseProgressDialog [<SwitchParameter>]
Switch parameter that, when used with the ShowProgressDialog parameter, will cause the progress dialog to
remain open after the migration task has completed until the progress dialog is manually closed. The invoke
cmdlet will not terminate until the progress dialog has been closed.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEMigrateUserData -UserCollectionId "All Users" -ConfigurationId
"CDB86C40-49E2-43E1-8DE5-E1B2F4A55B51"
Runs the MNE User Data Migrator with the "All Users" collection and the configuration with the GUID identifier
"CDB86C40-49E2-43E1-8DE5-E1B2F4A55B51". Returns the process results.
While the migration task is running, a progress dialog will be displayed indicating the task progress along with key
migration statistics. The progress dialog will be displayed on top of other windows and will remain open after the
task has completed until the progress dialog is manually closed.
Synopsis
Runs the Directory Exporter executable with the configuration in the database or user defined values.
Syntax
Invoke-MNENotesDirectoryExport [[-DominoServer] <string>] [[-UserIdFile] <string>]
[[-Password] <string>] [-WorkStation <WorkStation>] [-LogFile <string>]
[<CommonParameters>]
Description
Runs the get notes directory exporter executable with the configuration in the database or user defined values.
Parameters
-DominoServer <string>
Name of the Domino server to export directory from.
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserIdFile <string>
Location of the user ID file to log into the domino server.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Password <string>
The password to access the Domino server.
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
229
PowerShell cmdlets for Migrator for Notes to Exchange
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
File to log the results to. If specified, this is used, otherwise a default value is used.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNENotesDirectoryExport
Runs the MNE Directory Exporter task and returns the process results.
Synopsis
Runs the Provision Group Collection executable with the configuration in the database or user-defined values.
Syntax
Invoke-MNEProvisionGroupCollection [-GroupCollection] <string> [-GroupContainer
<string>] [-ContactContainer <string>] [-AddNotFoundContacts] [-KeepGroupsInSync]
[-SwitchToSecurityGroup] [-WorkStation <WorkStation>] [-LogFile <string>]
[<CommonParameters>]
Description
Runs the provision group collection application with a specified configuration or user defined values.
Parameters
-GroupCollection <string>
Guid or name of the group collection to provision.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Name or Guid of the existing configuration to be used for this task.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFilename <string>
Path to the configuration settings .ini file to be used for this task.
Required: true
Position: named
-GroupContainer <string>
Path to existing organizational unit for distribution groups.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ContactContainer <string>
Path to existing organizational unit for creating external members for distribution groups.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AddNotFoundContacts [<SwitchParameter>]
Switch parameter that, if used, will add contacts not found in Active Directory to AD.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-KeepGroupsInSync [<SwitchParameter>]
Switch parameter that, if used, will keep the provisioned group in sync with the Notes group.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SwitchToSecurityGroup [<SwitchParameter>]
Switch parameter that, if used, will provision the new group as a security group instead of a distribution
list.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
-LogFile <string>
Logfile to which the results will be logged. Uses a default file if parameter is not specified.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEProvisionGroupCollection -GroupCollection "All Groups" -LogFile
"C:\Log.txt"
Runs the NME Provision Group Collection task, logs to Log.txt on the C: drive, and returns the status.
Synopsis
Runs the Provision User Collection application with a specified configuration or user-defined values.
Syntax
Invoke-MNEProvisionUserCollection [-UserCollection] <string> -DatabaseColumn
<DbColumn> -AdAttribute <ActiveDirectoryAttribute> [-
CreateNonExistingUsersFromContacts] [-UserContainer <string>] [-WorkStation
<WorkStation>] [-LogFile <string>] [<CommonParameters>]
Description
Runs the Provision User Collection application with a specified configuration or user-defined values.
Parameters
-UserCollection <string>
GUID or name of the user collection to provision.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DatabaseColumn <string>
Database colummn to match to the selected active directory attribute (AdAttribute).
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdAttribute <string>
Active Directory attribute to match to the selected database colummn (DatabaseColumn).
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFilename <string>
Path to the configuration settings .ini file to be used for this task.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CreateNonExistingUsersFromContacts [<SwitchParameter>]
Switch parameter that, if used, will add users not currently in Active Directory to the AD.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserContainer <string>
Relative domain name path to an existing organizational unit for creating user object, must be specified if
CreateNonExistingUsers switch is on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogFile <string>
The file to which results will be logged. Uses a default value if parameter is not specified.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNEProvisionUserCollection -UserCollection "All Users" -DatabaseColumn
"GivenName" -AdAttribute "mailNickname" -LogFile "C:\Log.txt"
Runs the MNE Provision User Collection task with user-defined values and returns the status.
Synopsis
Sends PABs to all collection members
Syntax
Invoke-MNESendPabReplicator -CollectionName <string> -ConfigurationGuid <Guid> [-
WorkStation <WorkStation>] [-LogFile <string>] [<CommonParameters>]
Description
Sends Pabs to all collection members.
Parameters
-DominoServer <string>
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserIdFile <string>
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Password <string>
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CollectionName <string>
Name of the collection to send the Pabs to.
Required: true
Position: Named
Default value:
Accept pipeline input:false
-ConfigurationGuid <Guid>
Guid of the configuration for the cmdlet.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetServer <string>
Target Domino Server.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetDir <string>
Target Destination Directory.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MessageSubject <string>
Subject for the message.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MessageFrom <string>
Mark the message as sent from this user.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WorkStation <WorkStation>
The WorkStation to run this task on.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
TaskRunInfo
Returns a TaskRunInfo object that contains information regarding the invoked task.
Examples
PS C:\>Invoke-MNESendPabReplicator -CollectionName "All Users" -ConfigurationGuid
e6a70f5e-e0d3-4692-a5ad-08b541ace006
Sends the PABs using all the settings from the configuration.
Synopsis
Runs the Self Service Desktop Migrator (SSDM) executable with the configuration in the database or user-defined
values.
Syntax
Invoke-MNESSDM -TargetProfile <string> [-NotesUserIdPath <string>] [-NotesPassword
<string>] [-TargetPassword <string>] [-TargetUser <string>] [-TargetServer
<string>] [-TargetDomain <string>] [-DontMigrateMailFile] [-DontMigrateArchive] [-
DontMigrateAddressBook] [-AddressBookFilePath <string>] [-MailFilePath <string>] [-
MailArchivePath <string>] [<CommonParameters>]
Description
Runs the self service desktop manager executable with the configuration in the database or user defined values.
Parameters
-TargetProfile <string>
Name of the outlook profile to migrate to.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesUserIdPath <string>
Full path to the Notes user id file.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesPassword <string>
Password for the notes user.
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetPassword <string>
Password for the outlook profile.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
240
PowerShell cmdlets for Migrator for Notes to Exchange
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetUser <string>
Username of the AD user to attach to.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetServer <string>
Active Directory server to attach to.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetDomain <string>
Active Directory Domain to attach to.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DontMigrateMailFile [<SwitchParameter>]
Changes the ini to exclude the migration of mail files.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DontMigrateArchive [<SwitchParameter>]
Changes the ini to exclude the migration of mail archives.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DontMigrateAddressBook [<SwitchParameter>]
Changes the ini to exclude the migration of address books.
-AddressBookFilePath <string>
Full path to the address book file.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailFilePath <string>
Full path to the mail file.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailArchivePath <string>
Full path to the mail archive file.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Returns done or job failed status at the end of the run.
Examples
PS C:\>Invoke-MNESSDM -TargetProfile "Outlook"
Runs the MNE SSDM and returns the status.
Synopsis
Creates and saves a new configuration to the database.
Syntax
New-MNEConfiguration [-Name] <string> [[-Type] <ConfigurationTypeEnum>] [[-
Description] <string>] [<CommonParameters>]
Description
Creates a new configuration or configuration template with a user-specified name, type, and description, and/or
and saves it to the database.
Parameters
-Name <string>
Name of the new configuration to create. Name automatically appends the current date/time to the end.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Type <ConfigurationTypeEnum>
Type of configuration to create.
Required: false
Position: 1
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Description <string>
Description for the configuration.
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MakeTemplate [<SwitchParameter>]
Converts configuration into a template configuration.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
244
PowerShell cmdlets for Migrator for Notes to Exchange
Required: false
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TemplateType <TemplateTypeEnum>
Convert the Template Configuation to Full Template or Differential Template.
Required: false
Position: Named
Default value:.Full
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.String
Name of the new configuration to create.
ConfigurationTypeEnum
Type of configuration to create.
Outputs
NMEConfiguration
Outputs the created configuration.
Examples
PS C:\>New-MNEConfiguration -Name "NewConfiguration"
Creates a new configuration with the name "NewConfiguration" plus the current date/time.
Synopsis
Creates a new configuration of the type for Directory Export.
Syntax
New-MNEDirectoryExportConfiguration -Name <string> [<CommonParameters>]
Description
Creates and saves a new configuration of type ConfigurationTypeEnum.DirExport, with name specified by the
user.
Parameters
-Name <string>
Name of the configuration to create.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
Configuration
Outputs the newly created configuration.
Examples
PS C:\>New-MNEDirectoryExportConfiguration -Name "NewConfiguration"
Creates a new configuration with the given name and of type ConfigurationTypeEnum.DirExport.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
246
PowerShell cmdlets for Migrator for Notes to Exchange
Remove-MNECollectionMember
Synopsis
Removes a member object to the specifies collection.
Syntax
Remove-MNECollectionMember [-CollectionGuid] <Guid> [-ObjectSmtpAddress] <string>
[<CommonParameters>]
Description
Removes a specified object (either selected by GUID, SMTP address, or passed in) to the specified collection (by
GUID).
Validates whether there is an object GUID, SMTP address, or a CollectionMember are given in the input.
Parameters
-CollectionGuid <Guid>
The Guid of the collection to removed the member from.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-ObjectSmtpAddress <string>
The SMTP address of the object to be removed from the collection.
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ObjectGuid <Guid>
The Guid of the object to be removed from the collection.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
247
PowerShell cmdlets for Migrator for Notes to Exchange
Accept wildcard characters:false
-CollectionMember <CollectionMember>
The CollectionMember to be removed from the collection.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
The parameter CollectionGuid accepts pipeline input.
Outputs
QuestSoftware.NMEAPI.Controllers.NMECollection
Returns the collection that was removed from, if there are no errors.
Examples
PS C:\>Remove-MNECollectionMember -CollectionGuid 455E1829-45D1-4485-8467-
80A463DA5227 -ObjectGuid DA096D83-A07D-44F6-A0D2-35B88A10F6A5
Removes the object with the given Guid from the collection with the given Guid.
Synopsis
Remove the MNE admin user Full Access permission to mailboxes in the user collection for Office 365. If Admin
Account Pool is used, the Office365 admin role specified by the configuration will be used instead of the MNE
admin user.
Syntax
Remove-MNEMailboxAdminPermission [-CollectionName] <string> [<CommonParameters>]
Description
The admin user must be granted Full Access permission to mailboxes in the user collection prior to migration. After
completion of the migration, use this cmdlet to revoke admin user Full Access permission to the mailboxes in the
user collection. This cmdlet takes the user collection name and revokes the Full Access permission of the admin
user.
Parameters
-CollectionName <string>
Name of the user collection containing the mailboxes granted Full Access permission to Exchange admin
user.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationId <string>
Name or Guid of the existing configuration to use.
Required: true
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConfigurationFileName <string>
File name of a configuration settings .ini file to use as the configuration.
Required: true
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
249
PowerShell cmdlets for Migrator for Notes to Exchange
Position: Named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
QuestSoftware.NME.PSModule.Utils.ManageMailboxPermissionResult
Returns a ManageMailboxPermissionResult object that contains information regarding the result of this
cmdlet.
Examples
PS C:\>Remove-MNEMailboxAdminPermission "All Users"
Revokes the MNE admin user Full Access permission to mailboxes in the "All Users" collection using default
configuration setting and returns the results.
Synopsis
Allows you to set absolutely everything in the configuration.
Syntax
Set-MNEConfiguration [-ConfigurationFromPipeline] <Configuration> [-Section]
<string> [-Key] <string> [[-Value] <string>] [<CommonParameters>]
Description
The cmdlet allows you to set every part of the configuration through parameters.
Parameters
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Section <string>
Required: true
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Key <string>
Required: true
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Value <string>
Required: false
Position: 3
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AclIgnore <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AclIgnoreCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AclRootVisibleOnly <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Acls <Boolean>
Required: false
Position: named
Default value:
-ActiveDirectoryAlwaysUseDefaults <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ActiveDirectoryGroupType <ActiveDirectoryGroupTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ActiveDirectoryHost <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ActiveDirectoryPassword <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ActiveDirectoryUserId <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Ad2AdAttribute <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Ad2OpenFlags <AuthenticationTypes>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Ad2UserFilter <string>
Required: false
Position: named
-AdAttribute <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AddFullAccessPermission <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AddressListName <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AddressPolicyName <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdjustTaskReminderToMidnight <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdminDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdminMailbox <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdminPassword <string>
Required: false
-AdminProfile <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AdminUsername <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AllowForwardToNotesConnector <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AllowHtmlCalendarBodies <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AllowNotesForeignDirSync <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AllowSelfSignedCerts <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AltAddressAttribute <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AlwaysDoForwarding <Int32>
-AlwaysRmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AlwaysUseDefaults <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AlwaysUseOldAlias <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AlwaysUseOldExchDn <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppDoesArch <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppDoesEncrypted <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppDoesMail <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppendSmtpAddressToContactsDisplayName <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppointmentForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AppointmentLocationSource <Int16>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveDesignClass <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveDest <GeneralDestinationTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveDestServerArchive <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveReplicaServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ArchiveResolveAttendees <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AskArchiveDest <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AskFilter <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AskPabDest <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AskServerMailDest <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AttachmentFilteredBySizeMsg <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
-AttachmentLostDueToEncryptionMsg <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Attribute <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AuthMechanismType <AuthenticationMechanismTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AutodiscoverDisableMapiHttp <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AutodiscoverEnableScpLookup <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AutodiscoverMaxHops <Integer>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AutodiscoverPreferInternalRpcHttpUrl <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AutodiscoverPreferInternalUrl <Nullable<Boolean>>
Required: false
Position: named
Default value:
-AutodiscoverUrl <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-BodyLostDueToEncryptionMsg <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CalMaxRecurrenceFixType <CalMaxRecurrenceFixTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CanAddGroupMembers <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CanDeleteGroupMembers <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CentralLogDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CentralLogLevel <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CmnExcludeFromDirSync <string>
Required: false
Position: named
-CompressLogFile <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ContactFilter <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ContactsName <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CreateFwdAddrInAd <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CreateGroupDelay <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CreateMailBox <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CreateMailboxDelay <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CurArchiveDir <string>
Required: false
-CurMailFileDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DateFilterUsingFormula <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DeclineFolderCheck <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DeleteAutoCompleteMessages <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DeleteMailDomain <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DisableCredentialScanner <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DisableDialogScanner <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DisableModernAuthentication <Boolean>
-DisableDirSync <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoAuditLog <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DocLinksDefaultServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DocLinksFastLookupOnly <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DocLinksHttpPort <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoHtmlBody <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoMailRouting <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DomainController <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DominoDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoNeedAdsi <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoNeedCdoexm <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoNotesMailRouting <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoRmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSetCalDomain <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSetForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSetMailDomain <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSetMailSystem <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSetNotesFormatPreference <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoShowRmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoShowSetForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoSourceAdmin <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
-DoTargetAdmin <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoVisibility <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DoX500Proxy <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EmailAddressPolicyEnabled <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EnableArchiveMailbox <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EnableUsers <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EncryptedMailOnly <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EndUserDir <string>
Required: false
Position: named
Default value:
-EndUserStatsDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ExcalconServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ExchangeServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ExcludeDominoDomainFromFwdAddrInAD <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FileAsFormat <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FindArchivesBy <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FindMailFilesBy <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FindPabsBy <string>
Required: false
Position: named
-ForceAddrBooks <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForceAddress <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForceOldNxRtfDll <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForceTargetAdmin <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForwardingAddress <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForwardingDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ForwardingMethod <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FwdAddrDelim <string>
Required: false
-FwdAttrField <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FwdCalDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FwdMailDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-GroupContactsContainer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-GroupFilter <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-GroupsContainer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-GroupsSearchFilter <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-HomeMailBoxStore <string>
-HomeServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-HtmlDocLinks <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IgnoreAcls <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IgnoreForms <IList`1[String]>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IncludeServerMailFile <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-JournalEntryMessageType <NotesJournalEntryMessageTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LoadMethod <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LocateMailFiles <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LocateNew <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LocatePabs <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LogLevel <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-LookupDisplayNames <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailDesignClass <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailEnableRetryWaitSeconds <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailFileDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailSystem <MailSystemTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MailTarget <MailTargetTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MapiAdminProfile <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MapiRecipient <MapiRecipientActionEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MapiRetryCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
-MapiUseSharedProfile <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MapPrivateAsPublic <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxExceptionsPerMessage <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxExtractedImageArea <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxFolderCache <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxLargePstSize <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxMailboxConnectionRetryWaitTime <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MaxPstSize <Int32>
Required: false
Position: named
Default value:
-MaxSessionReconnectCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MBoxFromContact <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MemoForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeAddressBookFolder <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeAddressBooks <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeContactAttribWins <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeContactIsAuthoritative <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeCrossCheckObjs <Boolean>
Required: false
Position: named
-MergeFindBySmtp <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeGrpMembership <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeReqImportedFrom <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeReqProxyAddress <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeSyncObjRequired <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MergeX500 <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MessageRetryCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MessageRetryWait <Int32>
Required: false
-Migrate <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateAppointmentResponses <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateArchives <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateConflictDocs <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateEmptyFolders <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateMailOrCalendar <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateMailUsingServer <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateOrphanedDocs <Boolean>
-MigratePab <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateRecurringBeforeRange <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateReservationsAlways <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrateServerMail <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MimeIgnoreBoundaryWhitespace <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MinSpace <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NabCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NabReaderGroup <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NeedLoginInfo <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NoServer <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesAlwaysDoForwarding <Int16>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesAlwaysRmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesAlwaysUseDefaults <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesDoSetForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesDoShowRmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesDoShowSetForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesEncryptedMailOnly <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesFormatPreference <NotesFormatPreferenceTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesForwardingDomain <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesFwdAddrDelim <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
-NotesFwdAttrField <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesIniPath <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesPassword <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesPreferredNab <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotesUserIdFile <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NoticeForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-O365Environment <string>
Required: false
Position: named
Default value:
-O365MaxMailboxConnectionWaitTime <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-O365PSConnectionUri <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Offline <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-OpenFlags <AuthenticationTypes>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-OrphanedDocsFolder <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-OwnerByAcl <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabDesignClass <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabDest <GeneralDestinationTypeEnum>
Required: false
Position: named
-PabDestServerArchive <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabGroupForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabPersonForm <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicaDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicaServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicatorFrom <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicatorSign <Boolean>
Required: false
-PabReplicatorSubject <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicatorTargetDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabReplicatorTargetServer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabRequiredAttrs <IList`1[String]>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PabsInMailFile <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-Pass2Delay <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PostLogs <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PowerShellXmlErrorFile <string>
-ProvisionUsers <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PsRetryAttempts <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PsRetryWait <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PstDirMode <OutlookPstDirectoryModeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PstFileName <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PstFileNameFormat <OutlookPstFileNameFormatEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PstRootDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-PurgePabs <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QuotaMode <NotesQuotaModeTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-QuoteNonAsciiCharsInRtf <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RemigrateMode <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RemoveDirSyncAttribute <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RemoveSrcAddresses <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ReplaceForwardAddressInUserName <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ReportMofN <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ReportPct <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ReservationForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RewriteRtf <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RmvForwarding <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RootFolderAclMode <RootFolderAclModeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RpcProxyServerCertificationUrl <Uri>
Required: false
Position: named
Default value:
Accept pipeline input:false
-RPCProxyServerUrl <Uri>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RpcUseAuthType <OutlookLogonNetworkSecurityEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RPCUseFastHttp <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RPCUseHttp <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RPCUseProxyCertification <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RPCUseSlowHttp <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RPCUseSsl <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RunAsService <Boolean>
Required: false
Position: named
Default value:
-RunUpdateAddressList <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RunUpdateEmailAddressPolicy <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SelectedMailFile <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SelectedProfile <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SelectedPstDir <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SendStatus <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ServerMailDest <GeneralDestinationTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ServerMailDestServerArchive <Boolean>
Required: false
Position: named
-ServerMailResolveAttendees <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SetManagedByToUserForest <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SetPersonDocCustom <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SetUserAccountControl <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SkipDisabledGroupMembers <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SharePointServerName <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ShowSetMailDomain <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SkipCompletedTasks <Boolean>
Required: false
-SkipConflictDocs <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SkipNotes <IList`1[String]>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SkipOutOfRangeException <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SmtpForwardingAddress <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SmtpTranslationTable <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SourceAdminDirSync <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SqlColumn <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SqlCredentials <string>
-StationaryFolder <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-StationaryForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetType <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TargetTypeTested <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TaskForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TaskNoticeForms <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ThreadCount <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TotalSelArchives <Int64>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TotalSelMailFiles <Int64>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UpdateMode <NotesUpdateModeTypeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UpdateRtfFonts <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseAdminAcctPool <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseAppNxRtfDll <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseAutodiscoverCreateProfile <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseFilteredBodyMsg <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseImapFlags <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseLargePsts <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseMailFileOnly <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseMailFileOwner <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserAccountControl <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserContainer <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
-UserFilter <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserFolderPrefix <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserForestHost <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserForestPassword <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UserForestUserId <string>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UsePseudoRoot <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseSeparatePsts <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseSpecialArchiveFolder <Boolean>
Required: false
Position: named
Default value:
-UseUserForest <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-VisibilityMode <NotesVisibilityModeEnum>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WatchDogMinutes <Int32>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WriteCpidForRichText <Boolean>
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
Configuration
The configuration object to update. This parameter accepts input from the pipeline.
Outputs
None if successful.
Examples
PS C:\>Set-MNEConfiguration -ConfigurationFromPipeline $Config -Acls $true -
AllowForwardToNotesConnector $false
Sets the specified values.
Synopsis
Sets the database connection string for Notes Migrator for Exchange.
Syntax
Set-MNEDatabaseConnectionString [-IntegratedSecurity <Boolean>] [-DbUser <string>]
[-DbPassword <string>] -DbServer <string> -DbSharedDir <string> [<CommonParameters>]
Description
Sets the database connection string.
There are two parameter sets, based on whether you are accessing the database using Windows Authentication
or SQL Authentication.
The database name and database provider are constant for MNE.
Parameters
-IntegratedSecurity [<Boolean>]
Used if the database is accessed using Windows Authentication.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DbUser <string>
Used if the database is accessed by SQL Server Authentication.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DbPassword <string>
Used if the database is accessed by SQL Server Authentication.
Required: false
Position: named
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
298
PowerShell cmdlets for Migrator for Notes to Exchange
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DbServer <string>
Server of the database being accessed.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DbSharedDir <string>
Shared directory of the database being accessed.
Required: true
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
This cmdlet returns no value or output upon success.
Examples
PS C:\>Set-MNEDatabaseConnectionString -IntegratedSecurity $true -DbServer "(local)"
-DbSharedDir "\\Computer\C$\NME Stuff\"
Uses Windows Authentication to connect to the server and set the database connection string.
Synopsis
Sets a design class in the database.
Syntax
Set-MNEDesignClass -DesignClassGuid <Guid> [-Authoritative <Boolean>] [-
DataStoreTypeMask <DataStoreTypeMaskEnum>] [<CommonParameters>]
Description
Sets the Authoritative status and/or the DataStoreTypeMask for a design class in the database, selected either by
name or Guid.
Parameters
-DesignClassGuid <Guid>
Guid of the design class to set.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-DesignClassName <string>
Name of the design class to set.
Required: true
Position: named
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
-Authoritative <Boolean>
Whether the design class to set has authoritative status.
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-DataStoreTypeMask <DataStoreTypeMaskEnum>
Data store type mask of the design class to set.
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
300
PowerShell cmdlets for Migrator for Notes to Exchange
Required: false
Position: named
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
System.Guid
Guid of the design class to set.
System.String
Name of the design class to set.
Outputs
NMEDesignClass
Outputs the design class that was set if there are no errors.
Examples
PS C:\>Set-MNEDesignClass -DesignClassName "TestName" -Authoritative $true -
DataStoreTypeMask All
Sets the specified design class in the database to the parameters given.
Synopsis
Sets the migration windows used in the SSDM Scheduling Administration tool.
Syntax
Set-MNEMigrationTimeWindow [-CollectionName] <string> [[-ConcurrentUsers] <Integer>]
[[-MigrationDateFrom] <string>] [[-MigrationDateTo] <string>] [[-EnableTimeWindow]
<Boolean>] [[-MigrationTimeFrom] <string>] [[-MigrationTimeTo] <string>]
[<CommonParameters>]
Description
Sets the migration windows used in the SSDM Scheduling Administration tool.
Parameters
-CollectionName <string>
Name of the collection to set the window for. The collection cannot be auto-defined.
Required: true
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-ConcurrentUsers <Integer>
Number of users that can migrate at one time.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrationDateFrom <string>
Date when users can start migrating.
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrationDateTo <string>
Date when users must stop migrating.
Required: false
Quest Migrator for Notes to Exchange 4.16.2 Administration Guide
302
PowerShell cmdlets for Migrator for Notes to Exchange
Position: 3
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EnableTimeWindow <Boolean>
Whether the users are limited to a certain time to migrate each day.
Required: false
Position: 4
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrationTimeFrom <string>
Time of day when users can start migrating.
Required: false
Position: 5
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-MigrationTimeTo <string>
Time when users must stop migrating.
Required: false
Position: 6
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
This cmdlet returns nothing.
Examples
PS C:\>Set-MNEMigrationTimeWindow -CollectionName "some users" -ConcurrentUsers 5 -
MigrationDateFrom "8/15/2013 8:45:00 AM" -MigrationDateTo "8/31/2013 4:00:00 PM" -
EnableTimeWindow $false
Sets the migration window for the collection "some users" to 8/15/2013 at 8:45:00 AM to 8/31/2013 at 4:00:00 PM,
Synopsis
Sets the configuration files used in the SSDM Scheduling Administration tool.
Syntax
Set-MNESchedulingConfigFile [[-XmlConfigPath] <string>] [[-CollWizPath] <string>]
[[-WebServiceLocation] <string>] [<CommonParameters>]
Description
Sets the configuration files used in the SSDM Scheduling Administration tool.
Parameters
-XmlConfigPath <string>
Path to the Xml Config File.
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-CollWizPath <string>
Path to the MNE Collection Wizard.
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-WebServiceLocation <string>
URI to the SSDM Web Service.
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Outputs
This cmdlet returns nothing.
Examples
PS C:\>Set-MNESchedulingConfigFile -XmlConfigPath "c:\conf.xml" -CollWizPath
"c:\collwiz.exe" -WebServiceLocation
"http://localhost/SSDMSchedulingWebService/SSDMSchedulingWebService.asmx"
Sets XmlConfigFile to c:\conf.xml, CollWizPath to c:\collwiz.exe, and WebServiceLocation to
http://localhost/SSDMSchedulingWebService/SSDMSchedulingWebService.asmx.
PS C:\>Set-MNESchedulingConfigFile
Doesn't change the parameters, unless the file doesn't exist or is invalid. In that case, it creates the file with empty
parameters.
Synopsis
Sets the settings used in the SSDM Scheduling Administration tool.
Syntax
Set-MNESchedulingSetting [[-UseSsdmSched] <Boolean>] [[-TimeOut] <Integer>] [[-
FileProc] <Integer>] [[-IsEmail] <Boolean>] [[-EmailAddresses] <String[]>] [[-
EmailSubject] <string>] [[-EmailBody] <string>] [[-EmailAutoSend] <Boolean>] [[-
SchedReminder] <Boolean>] [[-NotScheduled] <string>] [[-BeforeMigrationDate]
<string>] [[-AfterMigrationDate] <string>] [[-BeforeMigrationTime] <string>] [[-
AfterMigrationTime] <string>] [[-TooManyConnections] <string>] [[-RetryAttempt]
<Integer>] [[-RetryWaitMinute] <Integer>] [[-UseLimitedRetry] <Boolean>]
[<CommonParameters>]
Description
Sets the settings used in the SSDM Scheduling Administration tool.
Parameters
-UseSsdmSched <Boolean>
Whether or not to use SSDM Scheduling
Required: false
Position: 0
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TimeOut <Integer>
Session timeout in minutes
Required: false
Position: 1
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-FileProc <Integer>
Update progress in minutes
Required: false
Position: 2
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-IsEmail <Boolean>
Whether to email the migration team on problems.
-EmailAddresses <string[]>
The email addresses to send to when problems occur.
Required: false
Position: 4
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EmailSubject <string>
The subject of the email dispatched when problems occur.
Required: false
Position: 5
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EmailBody <string>
The body of the email dispatched when problems occur.
Required: false
Position: 6
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-EmailAutoSend <Boolean>
Whether the user automatically sends email if problems occur.
Required: false
Position: 7
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-SchedReminder <Boolean>
Lets users add a scheduled task if before window.
Required: false
Position: 8
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-NotScheduled <string>
Text the user sees if not scheduled to migrate.
-BeforeMigrationDate <string>
Text the user sees if before migration date window.
Required: false
Position: 10
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AfterMigrationDate <string>
Text the user sees if after migration date window.
Required: false
Position: 11
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-BeforeMigrationTime <string>
Text the user sees if before migration time window.
Required: false
Position: 12
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-AfterMigrationTime <string>
Text the user sees if after migration time window.
Required: false
Position: 13
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-TooManyConnections <string>
Text the user sees if too many users simulataneously migrating.
Required: false
Position: 14
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-RetryAttempt <Integer>
Number of SSDM retry migration attempts.
Required: false
-RetryWaitMinute <Integer>
Time to (in minutes) before retrying.
Required: false
Position: 16
Default value:
Accept pipeline input:false
Accept wildcard characters:false
-UseLimitedRetry <Boolean>
Whether to limit the number of retries.
Required: false
Position: 17
Default value:
Accept pipeline input:false
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
This cmdlet has no parameters that accept pipeline input.
Outputs
This cmdlet returns nothing.
Examples
PS C:\>Set-MNESchedulingSetting -UseSsdmSched $true -TimeOut 10 -FileProc 1000 -
IsEmail $false
Sets UseSsdmSched to true, the timeout to 10 minutes, the file proc to 1000 minutes, and IsEmail to false. The
rest of the parameters are left alone.
PS C:\>Set-MNESchedulingSetting
Doesn't change any of the parameters, unless the file doesn't exist or is invalid. In that case, it creates the file with
empty parameters.
Synopsis
Sets a Collection to be "visible" in the UI.
Syntax
Show-MNECollection [-Collection] <NmeCollection> [<CommonParameters>]
Description
Sets a Collection to be "visible" in the UI. The collection is added/updated in the database upon completion.
Parameters
-Collection <NmeCollection>
The collection object to be set visible.
Required: true
Position: 0
Default value:
Accept pipeline input:true (ByValue)
Accept wildcard characters:false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)
Inputs
NmeCollection
The collection to be set visible.
Outputs
None if successful.
Examples
Get-MNECollection -CollectionGuid "e50d5123-2ec8-4096-816e-8e0e458d12e7" | Show-
MNECollection
A collection is retrieved from the database and its visiblity is set to visible.
Post-installation configuration
These tasks configure the Migrator for Notes to Exchange process as a whole, so are typically performed before
the more specific configuration tasks for a particular migration project:
• How do I set the account permissions necessary for migration?
• How do I configure Migrator for Notes to Exchange for a non-English Notes locale?
• How do I enable remote management on an Exchange 2010 or later server?
Pre-migration preparations
These tasks are typically performed when configuring Migrator for Notes to Exchange for a particular migration
project:
• How do I add or edit program parameters?
• How do I migrate from a Notes environment with Symantec E-Vault?
• How do I migrate to an Exchange environment with a CAS Array?
• How do I prepare the SQL database for mailbox-enabling (if AD is configured for a resource forest and a
user forest)?
• How do I add to the list of AD attributes available for the merge function?
• How do I configure AD to replicate an AD attribute to the Global Catalog?
• How do I specify per-user locations for Notes source data?
• How do I specify per-user destination locations for users’ PST files?
• How do I specify whether to migrate to a single PST file (per user) or multiple PST files?
• How do I migrate Notes custom attributes?
• How do I customize the placeholder message that the Data Migration Wizard substitutes for encrypted
messages?
• How do I customize the placeholder message that the Data Migration Wizard substitutes for filtered
attachments?
• How do I create or edit a template for personalized user-notification emails?
• How do I synchronize directory data and update the SQL database?
IMPORTANT: Some parameters in different sections share the same keyname, so it is very important
that parameter values be entered and edited in the correct sections.
IMPORTANT: Some parameters in different sections share the same keyname, so it is very important
that parameter values be entered and edited in the correct sections.
IMPORTANT: In the current Migrator for Notes to Exchange version, this AdSearchCol parameter
value must be set to SearchKey2 (the default for this parameter) for the mailbox-enabling process to
succeed.
• AdAttribute: The AD attribute whose values the program should read in the AdSearchCol column of the
SQL database, to match corresponding user accounts in the resource and user forests. For example:
[ActiveDirectory2]
AdSearchCol=SearchKey2
AdAttribute=userPrincipalName
... tells the wizard to match AD objects with users such that the value of each AD object’s
userPrincipalName attribute matches the value of the corresponding user’s SearchKey2 column in the SQL
database.
If you need to enter or edit the AdSearchCol column values in the SQL database:
1 Within Notes Migration Manager, in the Export Notes Directory screen: Click Export objects to TSV. A
dialog box will prompt you for a destination folder and filename for the exported file.
2 Use Microsoft Excel (or some other program that can edit a tsv-format file) to enter or edit the contents of
the column you have designated as the AdSearchCol column.
3 In the Export Notes Directory screen: Click Import objects from TSV to import the edited .tsv file into the
SQL database. A dialog box will prompt you for the filename and its location.
The 26 defaults are defined by a series of ADML[#] parameters in the [ActiveDirectoryMatchList] section of the
Global Defaults and Task Parameters:
[ActiveDirectoryMatchList]
Count=26
ADML0=cn
ADML1=mail
ADML2=mailNickname
ADML3=proxyAddresses
ADML4=sAMAccountName
[...]
ADML25=extensionAttribute15
If the AD attribute you want to use is not among the 26 defaults, you can add one or more other attributes to the list
by defining each addition in the Global Defaults or Task Parameters. See How do I add or edit program
parameters? above for the procedure to add and edit these parameter(s):
• ADML[#]=<AttribName>
Each ADML[#] parameter names an AD attribute that the Provisioning Wizard will include in its list of
options, from which one attribute must be chosen to facilitate the matching of contacts with AD objects. The
digit(s) appended to an ADML[#] key name differentiate one parameter from another. The multiple ADML[#]
parameters need not appear in numerical order, and need not form an unirupted numerical sequence. But
the wizard will read only ADML[#] parameters whose differentiating digits are less than a value specified by
a Count parameter (see below).
NOTE: Migrator for Notes to Exchange’s Provisioning Wizard merge function requires that any AD
attribute added to the list be replicated to the Global Catalog. You can configure AD to replicate an
attribute to the Global Catalog; see How do I configure AD to replicate an AD attribute to the Global
Catalog?
• Count=<##>
A limit to the number of ADML[#] parameters (see above) that the Provisioning Wizard will process in this
section. The wizard will read only ADML[#] parameters whose differentiating digits are less than the Count
parameter value. For example, if:
CAUTION: This procedure manipulates AD configuration parameters, and an error could generate adverse
consequences throughout the Active Directory environment. Use extreme caution whenever
manipulating AD configuration parameters in this way.
NOTE: After importing values into any of the listed columns, you must run the Notes Data Locator Wizard so
the data stores that are specified by the values you provide are located and the user's datastore information
is updated. To run the Notes Data Locator Wizard, select the Locate Notes Data Stores page in Notes
Migration Manager.
For PABs: To designate the locations of user PABs, enter the appropriate per-user values into one of these
columns (not both):
• PABPaths column: The specific UNC path and filename for a user's Notes address book(s). Multiple
address books can be designated by separating them with a pipe ( | ) character. Ordinarily the full path and
file name are given, and file ownership is not checked. If a directory (only) is specified, all PABs found in the
directory are assumed to be owned by the user. Examples:
\\server\data\addr1.nsf | \\server\data\addr2.nsf
\\server\data\user\address_book.nsf
\\server\data\
• SharedPabDirs column: A file system directory or Notes server directory that contains NSF files for
multiple users. This column can be used to specify a more specific set of directories to scan for a user's
data, so the application can scan a subset of a larger shared directory structure and determine the owner
based on profile documents and/or ACLs. This is useful if a group of users to be migrated shares a
directory structure and you can't be certain that all address books belong to one user. If a file system path
is specified here, ownership is checked based on the profile documents and/or ACLs. Examples:
\\server\data\groupdir
\\server\data\groupdir\address_book.nsf
For Archives: To designate the locations of user archives, enter the appropriate per-user values into one of these
columns (not both):
• ArchivePaths column: The specific UNC path and filename for a user's Notes archive file(s). Multiple
archives can be designated by separating them with a pipe ( | ) character. Ordinarily the full path and file
name are given, and file ownership is not checked. If a directory (only) is specified, all archives found in the
directory are assumed to be owned by the user. Examples:
\\server\data\arch1.nsf | \\server\data\arch2.nsf
\\server\data\user\archive_jdoe.nsf
\\server\data\
• SharedArchiveDirs column: A file system directory or Notes server directory that contains NSF files for
multiple users. This column can be used to specify a more specific set of directories to scan for a user's
data, so the application can scan a subset of a larger shared directory structure and determine the owner
based on profile documents and/or ACLs. This is useful if a group of users to be migrated shares a
directory structure and you can't be certain that all address books belong to one user. If a file system path
is specified here, ownership is checked based on the profile documents and/or ACLs. Examples:
\\server\data\archives
\\server\data\archives\archive_jdoe.nsf
For Mail Files: To specify per-user locations and filenames for users’ source mail files in the SQL database rather
than from entries in the Data Migration Wizard, enter the appropriate per-user values into this column:
• MailFilePath column: The specific path and NSF filename to a user's mail file, used when an administrator
knows the specific path and NSF file name for each user. Example:
IMPORTANT: If any data rows remain in the original attrs.tsv file, ensure that no ID value in
customattrs.tsv is the same as any ID value in attrs.tsv. Custom attributes will not migrate
correctly if any ID value appears in both files.
▪ SourceProperty: Name of an attribute that has been added to a Notes mail message, or a Notes
contact, to be migrated to a property in Exchange.
▪ TargetPropertySet: The GUID for the target property set, which must be one of these values:
PS_PUBLIC_STRINGS
{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}
... where each 'H' is a hexadecimal character, with letters capitalized.
If the TargetPropertySet value is PS_PUBLIC_STRINGS, the familiar GUID for the set named will
be substituted for the string provided.
TargetPropertySet can be left blank, but in that case TargetProperty (see following) must be an
integer property ID in the range 0x0000-0x7FFF.
▪ TargetProperty: Name of the corresponding MAPI property in Exchange. A hexadecimal user-
property value is created in Exchange on each migrated mail message or contact with the Notes
property, which will hold the value. The hexadecimal values of the created properties are reported in
the log (search for "custom attr" in the log file).
If TargetPropertySet (above) is left blank, this TargetProperty value must be specified as a 16-bit
integer in the range 0x0000- 0x7FFF that is not already defined for some other MAPI property.
▪ TargetPropertyType: Data type of the MAPI property, which must logically correspond to the data
type used in Notes. Valid values are:
STRING
MV_STRING
SYSTIME
BOOLEAN
LONG
Also, "PT_" may be prepended to any of the five types above, so valid values include PT_STRING,
PT_MV_STRING, etc.
3 Save and close the updated customattrs.tsv file.
For example, a typical customattrs.tsv file might look something like this:
Batch-migration process
Other features
The following sections describe additional features that may be used to perform tasks in Migrator for Notes to
Exchange:
• How do I schedule tasks?
• How do I troubleshoot service startup permissions?
• How do I send pre- or post-migration notification emails to end users?
• How do I perform an offline migration?
• How do I migrate resources?
• How do I migrate mail-in databases?
• How do I save and restore all Migrator for Notes to Exchange-defined collections from TSV files?
On a member server
If the user is a member of a stand-alone member server:
NOTE: You typically do not need to configure a service to interact with the desktop, so you can leave
the Allow service to interact with desktop check box clear.
CAUTION: These steps tell you to modify the registry. Serious problems might occur if you modify the
registry incorrectly. Ensure that you follow these steps carefully. Quest strongly recommends that
you back up the registry before you modify it so you can restore the registry if a problem occurs.
NOTE: Use this Create new objects... feature only if no corresponding contact or user object already exists
in AD. If an AD user object exists without a corresponding contact, the wizard will mail-enable the existing
object.
NOTE: The Data Migration Wizard sets forwarding on a mail-in database if it is told to do so by setting the
MailAddress attribute in Notes Document Properties for the mail-in database.
Quest provides software solutions for the rapidly-changing world of enterprise IT. We help simplify the challenges
caused by data explosion, cloud expansion, hybrid datacenters, security threats, and regulatory requirements. We
are a global provider to 130,000 companies across 100 countries, including 95% of the Fortune 500 and 90% of
the Global 1000. Since 1987, we have built a portfolio of solutions that now includes database management, data
protection, identity and access management, Microsoft platform management, and unified endpoint management.
With Quest, organizations spend less time on IT administration and more time on business innovation. For more
information, visit www.quest.com.
T
target Exchange server version, 18
TargetAddress column in SQL Server database, 52,
73, 97
TargetAlias column in SQL Server database, 52
TargetForwardingAddress column in SQL Server
database, 52, 73, 97
task parameters, 14, 39, 42, 46, 57, 63, 76, 81, 87, 109,
312, 316