Note : L’intégration PowerShell nécessite un abonnement Pro ou Enterprise à ShareGate Migrate. Elle n’est pas disponible avec le plan Essentials.
Utilisez PowerShell pour générer un fichier de mappage des utilisateurs ShareGate Migrate (SGUM) à partir d’un fichier CSV.
Vous pouvez utiliser le fichier SGUM dans l’application Migrate ou dans un script PowerShell.
Note : L’application mappe automatiquement vos utilisateurs. ShareGate Migrate effectuera le mappage de tous les utilisateurs que vous n’ajoutez pas à votre fichier de mappage.
Prérequis
Accès à vos informations utilisateurs ou à votre Active Directory/Microsoft Entra ID.
Créer votre CSV
Vous pouvez créer le fichier CSV manuellement ou obtenir une liste d’utilisateurs depuis votre Active Directory. Vous aurez besoin d’un fichier CSV final avec deux colonnes : SourceValue et DestinationValue. Vous pouvez utiliser l’adresse courriel, le nom d’utilisateur, le nom d’affichage ou le nom complet.
Le fichier devrait ressembler à ceci dans Excel :
Astuce : Nous recommandons d’utiliser les adresses courriel, qui sont généralement uniques et incluent le domaine.
Créer votre script
Copiez et collez le script suivant dans l’application PowerShell de votre choix.
# Import the ShareGate module
Import-Module Sharegate
# Define the path to the CSV file containing user and group mappings
$csvFile = "C:\CSVfile.csv"
# Import the CSV file into a table variable, specifying the delimiter as a comma
$table = Import-CSV $csvFile -Delimiter ","
# Create a new mapping settings object to store user and group mappings
$mappingSettings = New-MappingSettings
# Loop through each row in the imported CSV table
foreach ($row in $table) {
# Set user and group mappings for each row in the CSV file
$results = Set-UserAndGroupMapping -MappingSettings $mappingSettings -Source $row.SourceValue -Destination $row.DestinationValue
# Output the source value for each row (for debugging or tracking purposes)
$row.SourceValue
}
# Export the user and group mappings to a file
Export-UserAndGroupMapping -MappingSettings $mappingSettings -Path "C:\FolderName\FileName"
Adaptez votre script pour qu’il fonctionne selon vos besoins. Voici quelques conseils :
$csvFile : Modifiez le chemin pour que le script utilise votre fichier CSV.
$table : Le délimiteur est le symbole utilisé dans votre CSV pour séparer les éléments de colonne. Assurez-vous que votre script utilise le même délimiteur que votre fichier (vous pouvez le vérifier rapidement en ouvrant le CSV dans le Bloc-notes).
foreach : Parcourt les valeurs de votre fichier CSV. Vous pouvez en savoir plus ici.
$results : Les résultats sont stockés dans une variable results au lieu d’être affichés dans la fenêtre PowerShell afin d’éviter des problèmes de performance.
$row.sourcevalue : Affiche la valeur source, ce qui vous permet de suivre la progression.
Export-UserAndGroupMapping : Modifiez le chemin pour enregistrer le nouveau fichier de mappage des utilisateurs ShareGate Migrate (SGUM) à l’emplacement et avec le nom de votre choix.
Utiliser le fichier SGUM
Vous pouvez importer le fichier SGUM dans un script de migration avec la ligne suivante :
$mappingSettings = Import-UserAndGroupMapping -Path "C:\FolderName\FileName.sgum"
Ensuite, appelez le mappage sur votre ligne Copy (cela fonctionne avec toutes les options de copie comme Copy-Site et Copy-Content). Ajoutez ce qui suit sur la même ligne que votre commande de copie :
-MappingSettings $mappingSettings
Vous pouvez aussi importer le fichier SGUM avec l’option de migration ShareGate Migrate dans Copy en cliquant sur le bouton Import dans le menu Map users and groups.
« Cet article a été traduit à l’aide de l’intelligence artificielle. En cas de doute, veuillez vous référer à la version originale en anglais. »