Global administrators can consent to the Azure ShareGate migration app within the ShareGate migration tool, Cloud copy, or through Microsoft. You can change this option anytime in the migration tool's security settings.
For information on the benefits of the Azure ShareGate migration app, see What is the Azure ShareGate migration app?
Note: The Azure ShareGate migration tool app requires consent from a global administrator. If your account is not a global administrator, you can request that a global admin consents for you. The Azure ShareGate migration tool app is not supported in GCC or GCC High environments. If a global admin previously consented to the app and you want to know why re-consent is needed, see Why does a global admin need to re-consent the Azure ShareGate migration app?
Index
- Consent through Microsoft
- Consent through the ShareGate migration tool
- Consent for Microsoft Teams private chat migrations
- Consent through the Cloud copy
- Troubleshooting
- Remove consent
Consent through Microsoft
Consenting through Microsoft is a third-party process that will not affect user association within the ShareGate migration tool or Cloud copy. The user account connected to the environment in the ShareGate migration tool or Cloud copy will still be the one associated with any tasks completed.
- To begin the consent process, a global administrator must follow this link to the Microsoft sign-in page.
- Sign in with global administrator credentials.
- After signing in, the Permissions requested page will show more details on the consent permissions.
- Click Accept.
Consent through the ShareGate migration tool
Consenting through the ShareGate migration tool requires that the user disconnects and reconnects to his environment. This ensures that completed tasks are not done under the global administrator's account.
- Disconnect from your environment in the ShareGate migration tool.
- Ask a global administrator to log in to your environment using their credentials.
- Follow the consent process once prompted.
- Once done, disconnect from the environment and connect again using your own credentials (to ensure that you are not running tasks on the global administrator's account).
For more on permissions, see Which permissions does the Azure ShareGate migration tool app need?
Consent for Microsoft Teams private chat migrations
Additional permissions, including Application permissions, are needed to migrate your Microsoft Teams private chats with the migration tool. With this process, you consent to all the standard permissions and the additional permissions needed to copy private chats.
- To begin the consent process, a global administrator must follow this link to the Microsoft sign-in page.
- Sign in with global administrator credentials.
- After signing in, the Permissions requested page will show more details on the consent permissions.
- Click Accept.
To review these additional permissions, see Which permissions does the Azure ShareGate migration tool app need?
Consent through Cloud copy
To consent through Cloud copy, a global admin can use his credentials to connect to the tenant during a copy.
You might not want to perform the task with a global admin's account. In that case, we recommend you consent through Microsoft directly or through the migration tool with the appropriate steps described in the article above.
Troubleshooting
If the app was consented and the change is not reflected in ShareGate's migration tool, try reconnecting your tenant in the Explorer.
Remove consent
To remove consent of the Azure ShareGate migration app, see How do I remove the Azure ShareGate migration tool app?