Hinweis: Die PowerShell-Integration erfordert ein ShareGate Migration Pro- oder Migration Ultimate-Paket. Sie ist mit Migration Essentials Mailbox oder Migration Essentials Files nicht verfügbar.
Mit PowerShell können Sie Ihre Migration von OneDrive for Business zu OneDrive for Business automatisieren.
Tipp: Wie Sie Ihre Dokumente in einen neuen OneDrive-Ordner migrieren, erfahren Sie unter Walkthrough - Migrate to a new OneDrive folder in PowerShell.
Hinweis: Ende Januar 2026 hat Microsoft damit begonnen, das IDCRL-Cookie einzustellen. Das bedeutet, dass in den meisten Microsoft 365-Mandanten nur noch die Methoden Browser und Modern authentication mit den Parametern -Browser und -ModernAuth funktionieren. Weitere Informationen zu dieser Änderung finden Sie unter Important change to "Other user" authentication for Microsoft 365.
Voraussetzungen
Sie sind globaler Administrator oder SharePoint-Administrator im Quell- und im Zielmandanten. Diese Rolle ist erforderlich, um eine Verbindung zur OneDrive-Stamm-URL herzustellen, die im Skript verwendet wird, zum Beispiel
https://tenantname-my.sharepoint.com/.Sie sind Websitesammlungsadministrator (SCA) für jedes OneDrive im Migrationsumfang. Wenn Sie noch nicht SCA der OneDrives sind, benötigen Sie die Berechtigungen eines globalen Administrators oder SharePoint-Administrators. Die Schritte 7 bis 12 weiter unten beschreiben, wie das geht.
Ihre OneDrives wurden bereitgestellt (das lässt sich mit dem Get-OneDriveURL-Cmdlet automatisieren).
Hinweis: Sie müssen für jedes OneDrive Websitesammlungsadministrator (SCA) sein, auch wenn Sie über höhere Administratorrechte verfügen. In den Schritten 7 bis 12 weiter unten fügen Sie sich mit Ihren Berechtigungen als SharePoint-Administrator oder globaler Administrator als SCA zu allen Ihren OneDrives hinzu. Wenn Sie bereits SCA aller OneDrives in Ihrem Umfang sind, können Sie die Schritte 7 bis 12 überspringen. Das PowerShell-Skript entfernt Ihre SCA-Berechtigungen, sobald es ein OneDrive migriert hat. Ein SharePoint-Administrator kann auf alle OneDrives zugreifen, für die meisten Vorgänge in ShareGate Migrate sind aber trotzdem Berechtigungen als Websitesammlungsadministrator erforderlich.
Anleitung
Für Ihre OneDrive for Business-Migration müssen Sie alle Quell- und Ziel-OneDrives in einer CSV-Datei auflisten und ein PowerShell-Skript erstellen, das diese Parameter durchläuft und jedes OneDrive kopiert.
CSV-Leitfaden für Ihre Migration erstellen
Gehen Sie zu All reports.
Klicken Sie oben rechts auf Create custom report.
Wählen Sie OneDrive for Business als Objekttyp aus.
Klicken Sie auf Continue without saving.
Wählen Sie Ihren Quellmandanten aus.
Klicken Sie auf Run.
Wählen Sie mit dem Kontrollkästchen oben in der Liste alle Ihre OneDrives aus.
Klicken Sie im Quick actions menu auf Edit.
Wählen Sie im Dropdownmenü Transformations die Option Add administrators aus.
Suchen Sie im angezeigten Feld Select user or group nach Ihrem Konto und fügen Sie es hinzu.
Klicken Sie auf Apply.
Klicken Sie zweimal auf Back, um zu Ihren Berichtsergebnissen zurückzukehren.
Klicken Sie oben rechts auf Export.
Speichern Sie die Datei auf Ihrem Laufwerk.
Wiederholen Sie die Schritte (1) bis (14) und wählen Sie in Schritt (5) Ihren Zielmandanten aus.
Öffnen Sie Excel.
Fügen Sie den ersten beiden Spalten die Titel SourceSite und DestinationSite hinzu.
Öffnen Sie die beiden Dateien, die Sie in den Schritten (14) und (15) gespeichert haben.
Führen Sie die Daten beider Dateien im neuen Dokument so zusammen, dass die Quell-URL und die Ziel-URL in der jeweiligen Spalte einander entsprechen.
Wenn das alphabetische Sortieren nicht funktioniert, können Sie Ihre Daten manuell neu anordnen oder mit Excel-Makros oder PowerShell eine Lösung finden.Speichern Sie diese neue Datei als CSV auf Ihrem Laufwerk.
Skript erstellen
Kopieren Sie das folgende Skript und fügen Sie es in die PowerShell-Anwendung Ihrer Wahl ein.
Import-Module Sharegate
# Define the CSV file path
$csvFile = "C:\CSV\CopyContent.csv"
# Import the CSV file
$table = Import-Csv $csvFile -Delimiter ","
# Define the source and destination connections
$srcSiteConnection = Connect-Site -Url "https://sourcetenantname-my.sharepoint.com/" -ModernAuth
$dstSiteConnection = Connect-Site -Url "https://destinationtenantname-my.sharepoint.com/" -ModernAuth
# Set variables for site and list operations
Set-Variable srcSite, dstSite, srcList, dstList
# Loop through each row in the CSV
foreach ($row in $table) {
# Clear previous values of variables
Clear-Variable srcSite
Clear-Variable dstSite
Clear-Variable srcList
Clear-Variable dstList
# Connect to source and destination sites
$srcSite = Connect-Site -Url $row.SourceSite -UseCredentialsFrom $srcSiteConnection
$dstSite = Connect-Site -Url $row.DestinationSite -UseCredentialsFrom $dstSiteConnection
# Get source and destination lists
$srcList = Get-List -Site $srcSite -Name "Documents"
$dstList = Get-List -Site $dstSite -Name "Documents"
# Copy content from source list to destination list
Copy-Content -SourceList $srcList -DestinationList $dstList
# Remove site collection administrator permissions
Remove-SiteCollectionAdministrator -Site $srcSite
Remove-SiteCollectionAdministrator -Site $dstSite
}
Passen Sie Ihr Skript an Ihre Umgebung an. Hier einige Hinweise:
$csvFile: Passen Sie den Pfad so an, dass er auf die zuvor gespeicherte CSV-Datei verweist.
$table: Das Trennzeichen ist das Symbol, mit dem Ihre CSV-Datei die Elemente einer Zeile trennt. Achten Sie darauf, dass Ihr Skript dasselbe Trennzeichen verwendet wie Ihre Datei (am schnellsten prüfen Sie das, indem Sie die CSV-Datei im Editor öffnen).
$srcSiteConnection und $dstSiteConnection: Ersetzen Sie die URL durch die Stamm-URL Ihrer OneDrives im jeweiligen Quell- und Zielmandanten. Für die Verbindung zu dieser URL benötigen Sie die Berechtigungen eines globalen Administrators oder SharePoint-Administrators.
Connect-site: Der Befehl zum Herstellen einer Verbindung mit einer SharePoint-Website oder OneDrive for Business. Wenn Sie die Authentifizierungsmethode von Modern authentication ändern müssen, lesen Sie Connect Site.
Set-Variable und Clear-Variable: Diese Befehle helfen, ein Problem zu vermeiden, bei dem Ihre Daten nach einem Verbindungsfehler im falschen OneDrive landen können.
foreach: Wir verwenden foreach, um die Werte in Ihrer CSV-Datei zu durchlaufen. Mehr dazu finden Sie hier.
-UseCredentialsFrom: Dieses Skript verwendet Modern authentication mit dem Parameter -UseCredentialsFrom, um eine einzelne Verbindung wiederzuverwenden. Beim Start fordert das Skript Sie zur Eingabe Ihrer Microsoft 365-Anmeldeinformationen auf. Wenn MFA in Ihren Mandanten nicht erzwungen wird, können Sie Ihr Skript so konfigurieren, dass es für die unbeaufsichtigte Planung einen Benutzernamen und ein Kennwort verwendet. Weitere Informationen finden Sie unter Connect-Site und Avoid repeatedly entering your credentials with the browser and modern connection methods.
Remove-SiteCollectionAdministrator: Diese Funktion entfernt Ihr Benutzerkonto nach der Migration eines OneDrive als Websitesammlungsadministrator. Weitere Informationen finden Sie unter Remove Site Collection Administrator.
Führen Sie Ihr Skript aus, sobald es korrekt angepasst und getestet wurde.
Wichtige Hinweise
Modern authentication mit -ModernAuth ist die sicherste und beständigste Authentifizierungsmethode für Microsoft 365. Sie kann mit den Variablen Username und Password verwendet werden, solange die Multi-Faktor-Authentifizierung (MFA) nicht erzwungen wird. Es gibt außerdem einige Einschränkungen. Unter Connect-Site erfahren Sie, wie Sie diese Verbindungsmethode auf verschiedene Arten nutzen oder bei Bedarf zu Browser authentication wechseln.
Migrationsberichte werden automatisch erstellt und stehen Ihnen unter Tasks zur Verfügung. Sie können die Berichte in Ihrem Skript auch mit Export-Report exportieren.
Sie können Ihre Migration mit PowerShell zeitlich planen, damit sie außerhalb der Geschäftszeiten läuft und die Leistung optimiert wird.
Informationen zur inkrementellen Migration finden Sie im Artikel Incremental update using PowerShell.
Wie Sie die Kopieroptionen von ShareGate Migrate nachbilden, lesen Sie unter Copy options in PowerShell.
Wenn Sie Hunderte von Gigabyte an Daten migrieren, empfehlen wir, mehrere CSV-Dateien zu erstellen, um die Migration in kleineren Batches auszuführen.
Skriptfehler und Tests: Testen Sie Ihr PowerShell-Skript an einer kleinen Auswahl von OneDrive-Konten, bevor Sie es breit einsetzen. So lassen sich mögliche Probleme in einem überschaubaren Rahmen erkennen.
Mehrsprachige Organisationen: Wenn Ihre Microsoft 365-Umgebung mehrere Anzeigesprachen verwendet, stimmt der Bibliotheksname, den Sie in Ihrem Skript an
-Nameübergeben, möglicherweise nicht mit dem tatsächlichen Anzeigenamen der Bibliothek überein. Eine Documents-Bibliothek heißt in einer deutschen Umgebung zum Beispiel Dokumente, wodurch das Skript fehlschlägt. Details finden Sie unter Cannot validate argument on parameter 'List' - multilingual organizations.
Dieser Artikel wurde mithilfe künstlicher Intelligenz übersetzt. Wenden Sie sich im Zweifelsfall an die englische Originalversion.
