Hinweis: Die PowerShell-Integration erfordert ein ShareGate Migrate Pro- oder Enterprise-Abonnement. Sie ist im Essentials-Plan nicht verfügbar.
Die PowerShell-Zuordnungsbefehle bilden die Zuordnungsoptionen nach, die Sie in ShareGate Migrate verwenden können, und geben Ihnen so mehr Kontrolle über Ihre Migration.
Verhalten von Zuordnungen
Wenn Sie in ShareGate Migrate eigene Zuordnungen festlegen, werden diese automatisch für künftige Migrationen mit derselben Quelle und demselben Ziel beibehalten.
Zuordnungen für Benutzer und Gruppen, Berechtigungsstufen und Websitevorlagen werden auf Ebene der Websitesammlung gespeichert, selbst wenn Sie beim Speichern Ihrer Zuordnungen auf Ebene einer Unterwebsite oder Liste verbunden sind.
Zuordnungen für Eigenschaften und Inhaltstypen werden auf Listenebene gespeichert.
Zuordnungstypen
Mit ShareGate Migrate können Sie eine Reihe von Elementen zuordnen. Die Zuordnungstypen sind:
Eigenschaften (nur mit Copy-Content verwendet)
Inhaltstypen (nur mit Copy-Content verwendet)
Websitevorlagen (nur mit Copy-Site verwendet)
Zuordnungsbefehle
Für jeden Zuordnungstyp stehen Ihnen sechs PowerShell-Befehle zur Verfügung. Diese Befehle sind:
Zuordnung festlegen: Erstellt neue Zuordnungen in Ihrem Skript.
Zuordnung exportieren: Exportiert Ihre Zuordnungen als ShareGate Migrate-Zuordnungsdatei.
Zuordnung importieren: Importiert Ihre Zuordnungen aus einer ShareGate Migrate-Zuordnungsdatei.
Zuordnung abrufen: Ruft die für eine andere Quelle und ein anderes Ziel gespeicherten Zuordnungen ab.
Zuordnung speichern: Speichert Ihre Zuordnungen für eine Quelle und ein Ziel.
Zuordnung entfernen: Entfernt bestimmte Zuordnungselemente aus den bestehenden Zuordnungen.
Hinweis: Das Festlegen von Zuordnungen in einem PowerShell-Skript speichert diese nicht automatisch für Ihre Quelle und Ihr Ziel. Verwenden Sie den Befehl Zuordnung speichern, um diese Zuordnungen für künftige Migrationen zu behalten.
Beispiel
Hier erfahren Sie, wie Sie eine Zuordnungsdatei erstellen und ein Skript mit verschiedenen Zuordnungsbefehlen aufbauen. Die Beispiele zeigen Benutzer- und Gruppenzuordnungen, ein häufiges Szenario, aber Sie können dieselben Prinzipien auf alle Zuordnungstypen anwenden.
Eine Zuordnungsdatei über die Benutzeroberfläche exportieren
Öffnen Sie ShareGate Migrate.
Wählen Sie in der Menüleiste Copy aus.
Wählen Sie Copy structure aus.
Stellen Sie eine Verbindung zu Ihrer Quell- und Zielwebsite her.
Klicken Sie auf Mappings.
Klicken Sie auf das Symbol Export user and group mappings.
Speichern Sie die SGUM-Datei auf Ihrem Laufwerk.
Tipp: Im Artikel Eine Benutzerzuordnung aus einer CSV-Datei erstellen erfahren Sie, wie Sie eine komplexe oder unternehmensweite Benutzerzuordnungsdatei erstellen.
Zuordnungen in einem PowerShell-Skript verwenden
Import-Module Sharegate
# Create a new mapping settings object
$mappings = New-MappingSettings
# Import user and group mappings from an external file
$mappings = Import-UserAndGroupMapping -MappingSettings $mappings -Path "C:\MyMappings\MyUserAndGroupMappingsFileName.sgum"
# Set mapping for unresolved users or groups to be assigned to the 'Inactive users group'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -UnresolvedUserOrGroup -Destination "Inactive users group"
# Set mapping for a specific user from 'John Smith' to 'John Doe'
$mappings = Set-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith" -Destination "John Doe"
# Remove a specific mapping for 'John Smith'
$mappings = Remove-UserAndGroupMapping -MappingSettings $mappings -Source "John Smith"
# Connect to the source site
$srcSite = Connect-Site -Url "http://myfarm1/sites/mysourcesite"
# Connect to the destination site
$dstSite = Connect-Site -Url "http://myfarm1/sites/mydestinationsite"
# Copy the source site to the destination site using mapping settings, enabling merge and subsites
Copy-Site -Site $srcSite -DestinationSite $dstSite -MappingSettings $mappings -Merge -Subsites
New-MappingSettings: Dieser Befehl überschreibt alle Zuordnungen, die Sie zuvor für die Quelle und das Ziel gespeichert haben.
$mappings: Wir wiederholen diese Variable und fügen in jeder Zeile -MappingSettings $mappings hinzu, um Elemente zu den Zuordnungen hinzuzufügen oder daraus zu entfernen.
Import-UserAndGroupMapping: Importiert eine Benutzerzuordnungsdatei. Die Datei kann viele Benutzerzuordnungen enthalten.
Set-UserAndGroupMapping: Fügt eine neue Benutzerzuordnung hinzu. In diesem Fall wird eine Zuordnung zu den Zuordnungen hinzugefügt, die Sie mit Import-UserAndGroupMapping. erstellt haben.
-Source und -Destination: Legen Sie mit -Source den Wert fest, den Sie zuordnen möchten, und legen Sie mit -Destination den neuen Wert fest.
-UnresolvedUserOrGroup: Sie können -Source durch -UnresolvedUserOrGroup ersetzen, wenn Sie alle verwaisten Benutzer einem anderen Benutzerkonto oder einer Sicherheitsgruppe (Active Directory) zuordnen möchten.
Remove-UserAndGroupMapping: Entfernt eine Benutzerzuordnung. In diesem Fall wird eine Benutzerzuordnung von den Zuordnungen abgezogen, die Sie in den vorherigen $mappings-Zeilen erstellt haben.
Copy Site: Der Befehl zum Kopieren einer Website. Fügen Sie -MappingSettings $mappings hinzu, um die Zuordnungen anzuwenden, die Sie in der Variablen $mappings erstellt haben.
Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.