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.
Ihre CSV-Datei erstellen
Sie können die CSV-Datei manuell erstellen oder eine Liste der Benutzer aus Ihrem Active Directory abrufen. Sie benötigen eine finale CSV-Datei mit zwei Spalten: SourceValue und DestinationValue. Sie können E-Mail-Adresse, Benutzername, Anzeigename oder vollständigen Namen verwenden.
So sollte die Datei in Excel aussehen:
Tipp: Wir empfehlen die Verwendung von E-Mail-Adressen, da diese in der Regel eindeutig sind und die Domain enthalten.
Ihr 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 Ihr Skript so an, dass es für Sie funktioniert. Hier sind einige Hinweise:
$csvFile: Passen Sie den Pfad so an, dass das Skript Ihre CSV-Datei aufruft.
$table: Das Trennzeichen ist das Symbol, das Ihre CSV-Datei zum Trennen der Spalteneinträge verwendet. 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. Mehr dazu erfahren Sie hier.
$results: Die Ergebnisse werden in einer Variable namens results gespeichert, anstatt in Ihrem 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 mit dem Namen Ihrer Wahl zu speichern.
Die SGUM-Datei verwenden
Sie können die SGUM-Datei importieren in einem Migrationsskript mit der folgenden Zeile:
$mappingSettings = Import-UserAndGroupMapping -Path "C:\FolderName\FileName.sgum"
Rufen Sie anschließend die Zuordnung in Ihrer Copy-Zeile auf (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 auf die Schaltfläche Import im Menü Benutzer und Gruppen zuordnen klicken.
Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.