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. 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 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 associated with any tasks completed.
To consent through Microsoft, follow these steps:
- A global admin must use this link to the Microsoft sign-in page.
- Sign in with his global admin 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 username and password. This ensures you are not running tasks with the global administrator's account.
For more on 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.
If the reconnection does not work and you connect with Browser authentication, you can try turning Single sign-on (SSO) off, as it can prevent the migration tool from confirming consent was granted in some cases.
Remove consent
To remove consent of the Azure ShareGate migration app, see How do I remove the Azure ShareGate migration tool app?