Hinweis: Für die PowerShell-Integration ist ein ShareGate Migrate Pro- oder Enterprise-Abonnement erforderlich. Sie ist im Essentials-Plan nicht verfügbar.
Verwenden Sie PowerShell, um aus einer CSV-Datei eine ShareGate Migrate-Benutzerzuordnungsdatei (SGUM) zu erstellen.
Sie können die SGUM-Datei in der Migrate-App oder in einem PowerShell-Skript verwenden.
Hinweis: Die Anwendung ordnet Ihre Benutzer automatisch zu. ShareGate Migrate ordnet alle Benutzer zu, die Sie nicht zu Ihrer Zuordnungsdatei hinzufügen.
Voraussetzungen
Zugriff auf Ihre Benutzerinformationen oder Ihr Active Directory/Microsoft Entra ID.
CSV-Datei erstellen
Sie können die CSV-Datei manuell erstellen oder eine Liste Ihrer Benutzer aus dem Active Directory exportieren. Die fertige CSV-Datei benötigt zwei Spalten: SourceValue und DestinationValue. Sie können E-Mail-Adresse, Benutzername, Anzeigename oder vollständigen Namen verwenden.
In Excel sollte die Datei folgendermaßen aussehen:
Tipp: Wir empfehlen die Verwendung von E-Mail-Adressen, da diese in der Regel eindeutig sind und die Domain enthalten.
Skript erstellen
Kopieren Sie das folgende Skript und fügen Sie es in die PowerShell-Anwendung Ihrer Wahl ein.
# 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"
Passen Sie das Skript an Ihre Umgebung an. Hier sind einige Hinweise:
$csvFile: Passen Sie den Pfad an, damit das Skript auf Ihre CSV-Datei zugreift.
$table: Das Trennzeichen ist das Symbol, mit dem Ihre CSV-Datei die Spalten trennt. Stellen Sie sicher, dass Ihr Skript dasselbe Trennzeichen wie Ihre Datei verwendet (eine schnelle Möglichkeit zur Überprüfung ist das Öffnen der CSV-Datei in Notepad).
foreach: Durchläuft die Werte in Ihrer CSV-Datei. Weitere Informationen finden Sie hier.
$results: Die Ergebnisse werden in einer results-Variable gespeichert, statt im PowerShell-Fenster ausgegeben zu werden, um Leistungsprobleme zu vermeiden.
$row.sourcevalue: Gibt den Quellwert aus, damit Sie Ihren Fortschritt verfolgen können.
Export-UserAndGroupMapping: Passen Sie den Pfad an, um die neue ShareGate Migrate-Benutzerzuordnungsdatei (SGUM) am gewünschten Ort unter dem Namen Ihrer Wahl zu speichern.
SGUM-Datei verwenden
Sie können die SGUM-Datei mit der folgenden Zeile in ein Migrationsskript importieren:
$mappingSettings = Import-UserAndGroupMapping -Path "C:\FolderName\FileName.sgum"
Fügen Sie anschließend den Aufruf der Zuordnung in Ihre Kopierzeile ein (dies funktioniert mit allen Kopieroptionen wie Copy-Site und Copy-Content). Fügen Sie Folgendes in derselben Zeile wie Ihren Kopierbefehl hinzu:
-MappingSettings $mappingSettings
Sie können die SGUM-Datei auch über die ShareGate Migrate-Migrationsoption in Copy importieren, indem Sie im Menü Map users and groups auf die Schaltfläche Import klicken.
Dieser Artikel wurde mithilfe künstlicher Intelligenz übersetzt. Wenden Sie sich im Zweifelsfall an die englische Originalversion.