Remarque : L'intégration PowerShell nécessite un forfait ShareGate Migration Pro ou Migration Ultimate. Elle n'est pas disponible avec les forfaits Migration Essentials Mailbox ou Migration Essentials Files.
Cet article concerne uniquement l'intégration de PowerShell de ShareGate Migrate.
L'authentification par application uniquement vous permet d'exécuter des migrations SharePoint et Teams depuis PowerShell sans compte d'utilisateur connecté. Au lieu d'identifiants d'utilisateur, ShareGate Migrate s'authentifie à l'aide d'un enregistrement d'application Azure.
Pendant la configuration, vous créerez un enregistrement d'application, téléverserez un certificat comme information d'identification et accorderez les autorisations d'API requises.
Vous utiliserez ensuite l'ID de l'application (client) et le certificat pour vous authentifier depuis PowerShell.
Avant de commencer
Forfait ShareGate Migration Pro ou Migration Ultimate
L'accès Administrateur général au locataire Microsoft 365 est nécessaire pour créer l'enregistrement d'application et accorder le consentement de l'administrateur
Configurer l'enregistrement d'application
Effectuez cette configuration dans chaque locataire vers lequel ou depuis lequel vous migrez.
Pour une application à locataire unique (utilisée dans un seul locataire), répétez la configuration complète pour chaque locataire.
Pour une application multilocataire (où un même enregistrement est réutilisé dans plusieurs locataires), effectuez les étapes dans votre locataire principal, puis accordez le consentement de l'administrateur dans chaque locataire supplémentaire.
Étape 1 : Générer un certificat
ShareGate utilise un certificat pour s'authentifier en tant que votre application. Exécutez le script PowerShell suivant pour générer un certificat autosigné dans le magasin de l'utilisateur local et l'exporter vers votre Bureau.
# Generate a self-signed certificate in your local user store
$certName = "AzureAppAuthCert"
$cert = New-SelfSignedCertificate -Subject "CN=$certName" -CertStoreLocation "Cert:\CurrentUser\My" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256
# Export the public key (.cer) - upload this to Azure in Step 3
Export-Certificate -Cert $cert -FilePath "$home\Desktop\$certName.cer"
# Export the private key as a .pfx - required if connecting via Option B
$pfxPassword = ConvertTo-SecureString -String "choose-a-strong-password" -Force -AsPlainText
Export-PfxCertificate -Cert $cert -FilePath "$home\Desktop\$certName.pfx" -Password $pfxPassword
# Copy this value for use with New-AzureApplication
Write-Host "Thumbprint: $($cert.Thumbprint)"
Les deux fichiers sont enregistrés sur votre Bureau. Téléversez le fichier .cer vers Azure à l'étape 3. Si vous prévoyez de vous connecter avec l'option B, vous aurez aussi besoin du fichier .pfx.
Notez l'empreinte numérique affichée dans la console. Vous l'utiliserez avec New-AzureApplication à l'étape Connect.
Étape 2 : Enregistrer l'application dans Microsoft Entra ID
Connectez-vous au centre d'administration Microsoft Entra en tant qu'administrateur général.
Accédez à Entra ID > App registrations > New registration.
Donnez un nom à l'application (par exemple, ShareGate Migration).
Sous Supported account types, choisissez My organization only pour une application à locataire unique, ou Multiple Entra ID tenants pour une application multilocataire utilisée dans plusieurs locataires.
Laissez le champ Redirect URI vide.
Cliquez sur Register.
Dans la page Overview, copiez l'Application (client) ID. Vous l'utiliserez avec
New-AzureApplication.
Étape 3 : Téléverser le certificat
Dans votre enregistrement d'application, accédez à Certificates & secrets > Certificates, puis sélectionnez Upload certificate.
Téléversez le fichier
.cerà partir de votre Bureau.Cliquez sur Add.
Étape 4 : Ajouter des autorisations d'API
Dans votre enregistrement d'application, accédez à API permissions > Add a permission.
Ajoutez chacune des Application permissions indiquées ci-dessous. Ajoutez les autorisations Microsoft Graph et les autorisations SharePoint comme entrées distinctes. Ne sélectionnez pas les Delegated permissions.
Cliquez sur Grant admin consent for [your tenant] et confirmez.
Autorisations Microsoft Graph :
| Appartenance aux canaux Teams |
| Paramètres des canaux Teams |
| Objets de l'annuaire |
| Fichiers de toutes les collections de sites |
| Groupes Microsoft 365 |
| Stratégies de protection des données |
| Étiquettes de confidentialité |
| Blocs-notes OneNote |
| Contrôle total de toutes les collections de sites |
| Création, modification et suppression d'éléments dans toutes les collections de sites |
| Lecture et écriture d'éléments dans toutes les collections de sites |
| Tâches Planner |
| Création d'équipes |
| Appartenance aux équipes |
| Installations d'applications Teams |
| Paramètres des équipes |
| Onglets dans les canaux Teams |
| Magasin de termes |
| Profils d'utilisateur |
Autorisations SharePoint :
Remarque : Les autorisations SharePoint se trouvent sous SharePoint dans la liste des API, et non sous Microsoft Graph.
| Contrôle total de toutes les collections de sites |
| Création, modification et suppression d'éléments dans toutes les collections de sites |
| Lecture d'éléments dans toutes les collections de sites |
| Lecture et écriture d'éléments dans toutes les collections de sites |
| Magasin de termes (lecture) |
| Magasin de termes (lecture/écriture) |
| Profils d'utilisateur (lecture) |
| Profils d'utilisateur (lecture/écriture) |
Se connecter depuis ShareGate
Créez un objet d'identification avec New-AzureApplication, puis transmettez-le à Connect-Site ou à Connect-Tenant.
Option A : Empreinte numérique du certificat (provenant du script de génération)
Si vous avez utilisé le script de l'étape 1, le certificat se trouve dans Cert:\CurrentUser\My. Transmettez directement l'empreinte numérique :
# Build a credential object from the certificate thumbprint
$app = New-AzureApplication -ClientId "<application-client-id>" -Thumbprint "<certificate-thumbprint>"
# Connect to a specific site
Connect-Site -Url "https://contoso.sharepoint.com/sites/Marketing" -AzureApplication $app
# Or connect at the tenant level
Connect-Tenant -Domain "contoso" -AzureApplication $app
Option B : Certificat provenant d'un fichier .pfx
Si vous avez le certificat sous forme de fichier .pfx, chargez-le directement :
# Load the certificate from a .pfx file
$certificate = [System.Security.Cryptography.X509Certificates.X509Certificate2]::new(
"C:\certs\sharegate-app.pfx",
"your-pfx-password")
# Build a credential object
$app = New-AzureApplication -ClientId "<application-client-id>" -Certificate $certificate
# Connect to a site
Connect-Site -Url "https://contoso.sharepoint.com/sites/Marketing" -AzureApplication $app
Un même objet d'application peut authentifier plusieurs connexions dans la même session. Réutilisez la même variable $app dans plusieurs appels à Connect-Site ou à Connect-Tenant.
Remarque : Si votre politique de sécurité vous empêche d'accorder l'une des autorisations requises, ajoutez -AllowMissingPermissions à Connect-Site ou à Connect-Tenant pour vous connecter malgré tout.
Les opérations qui dépendent de l'autorisation manquante échoueront avec des erreurs Forbidden.
Ce commutateur assouplit seulement la vérification des autorisations une fois l'authentification réussie. Il ne règle pas un échec de connexion.
Enregistrer et réutiliser une application
Vous pouvez enregistrer un objet d'enregistrement d'application et le récupérer dans des sessions ultérieures, afin de ne pas avoir à le recréer chaque fois. Utilisez Save-AzureApplication pour l'enregistrer et Get-AzureApplication pour le charger de nouveau.
Limitations connues
Les valeurs de métadonnées gérées ne sont pas conservées pendant la migration.
Les alertes d'utilisateur sont ignorées. L'authentification par application uniquement n'a pas de contexte d'utilisateur pour envoyer des alertes.
Les composants WebPart classiques ne sont pas migrés.
Les workflows SharePoint classiques ne sont pas migrés.
Les formulaires InfoPath sont migrés partiellement. Attendez-vous à des avertissements.
Les workflows d'approbation de publication nécessitent un contexte d'utilisateur. Attendez-vous à des erreurs ou à des avertissements.
Les étiquettes de confidentialité ne sont pas appliquées pendant la migration.
Les messages des canaux Teams ne sont pas copiés avec l'authentification par application uniquement.
Copier des conversations privées
Vous pouvez utiliser votre propre enregistrement d'application Azure pour exécuter Copy-Chat depuis PowerShell. Configurez l'enregistrement d'application et le certificat comme décrit plus haut, puis ajoutez les Application permissions Microsoft Graph suivantes. Elles ne figurent pas dans les listes de l'étape 4.
| Création de conversations |
| Lecture et écriture de toutes les conversations |
| Migration vers Microsoft Teams |
| Lecture et écriture des données de l'annuaire |
Pour obtenir une description de chaque autorisation, consultez Jeux d'autorisations Microsoft 365 requis pour ShareGate.
Pour vous connecter, utilisez Connect-MicrosoftOnline avec le paramètre -CopyFeature défini à ChatCopy. N'utilisez pas Connect-Tenant, qui est réservé aux migrations Teams.
# Build a credential object from the certificate thumbprint
$app = New-AzureApplication -ClientId "<application-client-id>" -Thumbprint "<certificate-thumbprint>"
# Connect to the tenant for Copy-Chat
$connection = Connect-MicrosoftOnline -TenantId "<tenant-id>" -AzureApplication $app -CopyFeature ChatCopy
Cet article a été traduit à l'aide de l'intelligence artificielle. En cas de doute, référez-vous à la version originale en anglais.
