ShareGate Desktop carries your associated permissions during a migration, and will attempt to preserve their integrity from the source to the destination whenever possible.
This article explains what happens to your permissions when running an Import from file share migration.
Index
- Users and groups Association (automatic mapping)
- Permissions on documents and folders
- How can I preserve my file share permissions?
Users and groups Association (automatic mapping)
Your users and groups are automatically mapped at the destination. This association is done through the SharePoint people picker to preserve your permissions, and Person or Group metadata values.
Permissions on documents and folders
The application will preserve permissions on files and folders with custom permissions at the source.
If there are no custom permissions on your documents and folders, they will inherit the permissions from the parent in SharePoint.
If the application finds custom permissions on your items at the source, the items will migrate with broken inheritance (custom permissions) at the destination, and all the permissions will be preserved.
Note: Special permission levels are not supported. Only permissions with one of the standard access levels below are migrated:
- Full Control
- Contribute
- Read & execute
- Read
- Write
How can I preserve my file share permissions?
The steps below will show you how to confirm the permissions in your file share, and set them so they are properly migrated in SharePoint:
- Locate a file or folder you need to preserve your permissions on.
- Right click on the item.
- Select Properties.
- Select the Security Tab.
- Click on Advanced.
- You will now be in the Advanced menu.
- Confirm if all the permissions are inherited from the parent under the Inherited from column.
- If they are, click on the Disable Inheritance button.
Note: Alternatively, you can add a custom permission on the item.
- ShareGate Desktop will now migrate the permissions for that item.
Note: Under the Access column, any permission that does not use a standard permission level will be ignored during the migration.
Tip: Because the permissions between your file share and SharePoint are handled differently, arranging your file share permissions can benefit from some planning.
Microsoft does not recommend disabling the permission inheritance on many files and folders, and suggests grouping your permissions as much as possible.
A good approach is to disable the permissions in the migration options and manually add them at the library, site, or site collection level.