Before a large update effort can be executed, a mapping file must be created. Under normal circumstances, this is done in the SMSS / Mapping tab when Source and Target namespaces are specified and the batch of Source accounts are selected from the Directory Namespace and dropped on the process grid.
When using the command line interface for this module, this process should be done ahead of time or done manually by programmatic scripting methods. The end result will be a large ASCII text file with two columns (TAB separated) showing the Source ID and the Target ID:
As large companies prepare their Mapping Files, they are often split into manageable batches around hundreds or a thousand at a time. This allows them to execute off hours and review the logs for issues the following day for any that may need to be handled with special circumstances.
Once at least one Mapping File has been created, it is best to go into the SMSS tool and create the initial job (MMX file) and all of its settings, then save them using the Save icon on the toolbar. While going through the save process, a new form (Command Line Settings) will display giving opportunity to set the many various settings needed to execute this process from the prompt, most importantly, the Mapping file that will be used. Once saved, open the MMX file in a text editor and review the settings to ensure everything is as needed.
**Note: Support for Preview Mode has been included to allow the command line process to run without making changes. This is valuable to review the logs and make sure all selections are as they should be. This mode can be changed within the configuration file.
controlpanel.exe -run -f="c:tempmig-01.mmx"