Migration Manager Settings
The following table details the settings available in the Migration Manager. Only your IT professional should manage the Advanced settings.
General
Setting | Description |
---|---|
Only perform scanning | If you wish to scan the files as a preassessment to migration, this setting should be set to On. |
Preserve file share permissions. | Preserve permissions on the files migrated. |
Users
Setting | Description |
---|---|
Microsoft Entra lookup | By default, this setting is set to On. If no user mapping file is provided by the user, then Microsoft Entra ID is used as the default for user mapping. |
User mapping file | By default, Microsoft Entra lookup is used to map users when submitting migration jobs. If you wish to use your own mapping file, select the file to be used by clicking Choose file. If you choose to use a custom user mapping file and want to preserve user permissions, turn off Microsoft Entra lookup. By doing so, if a user isn't found in the mapping file, the tool won't look it up in Microsoft Entra ID. You can also leave Microsoft Entra ID setting on AND use a custom mapping file. If domain users can't be found in the mapping file, the tool auto-detects destination users and its source user’s SID. |
Filters
The relationship between these filters is AND.
Setting | Description |
---|---|
Migrate hidden files | If set to Off, hidden files are not migrated. |
Migrate files created after | Only migrate files created after the selected date. This setting can be used to limit the number of files migrated or to adhere to overall company governance policy regarding file retention. |
Migrate files modified after | Only migrate files modified after the selected date. This setting can be used to limit the number of files migrated or to adhere to overall company governance policy regarding file retention. |
Don't migrate files with these extensions | Enter a list of file extensions of file types you don't want to migrate. Separate each extension entered with a colon. Don't include the dot. Example: TXT:EXE:JPEG: Note: For files with multiple file extensions, for example.ext1.ext2, add only the last extension, ext2, to the exclusion list. |
Migrate files and folders with invalid characters | By default, the setting is set to On. This value is the recommended setting. The tool attempts to move all files without filtering on characters. If any file can't be accepted, a failure message is generated for that file. If set to Off, the tool skips any potential special characters. While this can improve performance when the source potentially contains a high number of files containing invalid characters, it also has drawbacks. To prevent malicious activities, source packages that generate more than 100 errors to the destination server are blocked. As a result, all valid files in that package are also blocked. |
Advanced
Setting | Description |
---|---|
Migration auto rerun | Upon failure, retry task up to four times. Note: This setting is scheduled for deprecation. It is recommended to set it to Off. |
Migration Manager working folder | A temporary working folder is created named %appdata%\Microsoft\SPMigration . Make sure that your working folder has a minimum of 150 GB of free space. It may need more depending on the size of the data you plan to migrate. |