Passer au contenu principal

Configurer un enregistrement d'application Azure pour les migrations SharePoint par PowerShell

Comment configurer un enregistrement d'application Azure pour exécuter des migrations SharePoint et Teams avec PowerShell dans ShareGate Migrate, sans compte d'utilisateur connecté.

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

  1. Connectez-vous au centre d'administration Microsoft Entra en tant qu'administrateur général.

  2. Accédez à Entra ID > App registrations > New registration.

  3. Donnez un nom à l'application (par exemple, ShareGate Migration).

  4. 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.

  5. Laissez le champ Redirect URI vide.

  6. Cliquez sur Register.

  7. Dans la page Overview, copiez l'Application (client) ID. Vous l'utiliserez avec New-AzureApplication.

Étape 3 : Téléverser le certificat

  1. Dans votre enregistrement d'application, accédez à Certificates & secrets > Certificates, puis sélectionnez Upload certificate.

  2. Téléversez le fichier .cer à partir de votre Bureau.

  3. Cliquez sur Add.

Étape 4 : Ajouter des autorisations d'API

  1. Dans votre enregistrement d'application, accédez à API permissions > Add a permission.

  2. 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.

  3. Cliquez sur Grant admin consent for [your tenant] et confirmez.

Autorisations Microsoft Graph :

ChannelMember.ReadWrite.All

Appartenance aux canaux Teams

ChannelSettings.ReadWrite.All

Paramètres des canaux Teams

Directory.ReadWrite.All

Objets de l'annuaire

Files.ReadWrite.All

Fichiers de toutes les collections de sites

Group.ReadWrite.All

Groupes Microsoft 365

InformationProtectionPolicy.Read.All

Stratégies de protection des données

SensitivityLabels.Read.All

Étiquettes de confidentialité

Notes.ReadWrite.All

Blocs-notes OneNote

Sites.FullControl.All

Contrôle total de toutes les collections de sites

Sites.Manage.All

Création, modification et suppression d'éléments dans toutes les collections de sites

Sites.ReadWrite.All

Lecture et écriture d'éléments dans toutes les collections de sites

Tasks.ReadWrite.All

Tâches Planner

Team.Create

Création d'équipes

TeamMember.ReadWrite.All

Appartenance aux équipes

TeamsAppInstallation.ReadWriteForUser.All

Installations d'applications Teams

TeamSettings.ReadWrite.All

Paramètres des équipes

TeamsTab.ReadWrite.All

Onglets dans les canaux Teams

TermStore.ReadWrite.All

Magasin de termes

User.Read.All

Profils d'utilisateur

Autorisations SharePoint :

Remarque : Les autorisations SharePoint se trouvent sous SharePoint dans la liste des API, et non sous Microsoft Graph.

Sites.FullControl.All

Contrôle total de toutes les collections de sites

Sites.Manage.All

Création, modification et suppression d'éléments dans toutes les collections de sites

Sites.Read.All

Lecture d'éléments dans toutes les collections de sites

Sites.ReadWrite.All

Lecture et écriture d'éléments dans toutes les collections de sites

TermStore.Read.All

Magasin de termes (lecture)

TermStore.ReadWrite.All

Magasin de termes (lecture/écriture)

User.Read.All

Profils d'utilisateur (lecture)

User.ReadWrite.All

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.

Chat.Create

Création de conversations

Chat.ReadWrite.All

Lecture et écriture de toutes les conversations

Teamwork.Migrate.All

Migration vers Microsoft Teams

Directory.ReadWrite.All

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.

Avez-vous trouvé la réponse à votre question ?