Remarque : L'intégration PowerShell nécessite un abonnement Pro ou Enterprise à ShareGate Migrate. Elle n'est pas disponible avec le forfait Essentials.
Les commandes de mappage PowerShell reproduisent les options de mappage que vous pouvez utiliser dans ShareGate Migrate, vous offrant ainsi un meilleur contrôle sur votre migration.
Comportements de mappage
Lorsque vous définissez vos propres mappages dans ShareGate Migrate, ils sont automatiquement conservés pour les futures migrations que vous effectuez avec la même source et la même destination.
Les mappages de Utilisateurs et groupes, Niveaux d'autorisation et Modèles de site sont enregistrés au niveau de la collection de sites, même si vous êtes connecté au niveau d'un sous-site ou d'une liste lorsque vous enregistrez vos mappages.
Les mappages de Propriétés et de Types de contenu sont enregistrés au niveau de la liste.
Types de mappage
Vous pouvez mapper plusieurs éléments avec ShareGate Migrate. Les types de mappage sont :
Propriétés (Utilisé uniquement avec Copy-Content)
Types de contenu (Utilisé uniquement avec Copy-Content)
Modèles de site (Utilisé uniquement avec Copy-Site)
Commandes de mappage
Il existe six commandes PowerShell que vous pouvez utiliser pour chaque type de mappage. Ces commandes sont :
Set mapping : Créez de nouveaux mappages dans votre script.
Export mapping : Exportez vos mappages sous forme de fichier de mappage ShareGate Migrate.
Import mapping : Importez vos mappages à partir d'un fichier de mappage ShareGate Migrate.
Get mapping : Récupérez les mappages enregistrés pour une autre source et destination.
Save mapping : Enregistrez vos mappages pour une source et une destination.
Remove mapping : Supprimez des éléments de mappage spécifiques des mappages existants.
Remarque : Définir des mappages dans un script PowerShell ne les enregistre pas automatiquement pour votre source et destination. Utilisez la commande Save mapping pour conserver ces mappages pour de futures migrations.
Exemple
Découvrez comment générer un fichier de mappage et créer un script avec différentes commandes de mappage. Les exemples montrent des mappages des utilisateurs et groupes, ce qui est un scénario courant, mais vous pouvez appliquer les mêmes principes à tous les types de mappage.
Exporter un fichier de mappage depuis l'interface
Ouvrez ShareGate Migrate.
Sélectionnez Copy dans la barre de menu.
Sélectionnez Copy structure.
Connectez-vous à votre site source et destination.
Cliquez sur Mappings.
Cliquez sur l'icône Export user and group mappings.
Enregistrez le fichier SGUM sur votre disque.
Astuce : Consultez l'article Créer un mappage d'utilisateurs à partir d'un fichier CSV pour apprendre à créer un fichier de mappage d'utilisateurs complexe ou à l'échelle de l'entreprise.
Utiliser les mappages dans un script PowerShell
Import-Module Sharegate
# Créez un nouvel objet de paramètres de mappage
$mappings = New-MappingSettings
# Importez les mappages des utilisateurs et groupes à partir d'un fichier externe
$mappings = Import-UserAndGroupMapping -MappingSettings $mappings -Path "C:\MyMappings\MyUserAndGroupMappingsFileName.sgum"
# Définir le mappage pour les utilisateurs ou groupes non résolus afin qu'ils soient affectés au 'Inactive users group'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -UnresolvedUserOrGroup -Destination "Inactive users group"
# Définir le mappage pour un utilisateur spécifique de 'John Smith' vers 'John Doe'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith" -Destination "John Doe"
# Supprimer un mappage spécifique pour 'John Smith'
$mappings = Remove-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith"
# Connectez-vous au site source
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
# Connectez-vous au site de destination
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
# Copiez le site source vers le site de destination en utilisant les paramètres de mappage, avec fusion et sous-sites activés
Copy-Site -Site $srcSite -DestinationSite $dstSite -MappingSettings $mappings -Merge -Subsites
New-MappingSettings : Cette commande remplace tous les mappages que vous avez précédemment enregistrés pour la source et la destination.
$mappings : Nous réutilisons cette variable, en ajoutant -MappingSettings $mappings à chaque ligne pour ajouter ou supprimer des éléments des mappages.
Import-UserAndGroupMapping : Cette commande importe un fichier de mappage d'utilisateurs. Le fichier peut contenir de nombreux mappages d'utilisateurs.
Set-UserAndGroupMapping : Ajoute un nouveau mappage d'utilisateur. Dans ce cas, il ajoute un mappage à ceux que vous avez établis avec Import-UserAndGroupMapping.
-Source et -Destination : Définissez la valeur à mapper avec -Source et la nouvelle valeur avec -Destination.
-UnresolvedUserOrGroup : Vous pouvez remplacer -source par -UnresolvedUserOrGroup lorsque vous souhaitez mapper tous les utilisateurs orphelins vers un autre compte d'utilisateur ou un groupe de sécurité (Active Directory).
Remove-UserAndGroupMapping : Supprime un mappage d'utilisateur. Dans ce cas, il retire un mappage d'utilisateur de ceux que vous avez établis dans les lignes précédentes de $mappings.
Copy Site : La commande pour copier un site. Ajoutez -MappingSettings $mappings pour appliquer les mappages que vous avez définis dans la variable $mappings.
"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."