Zum Hauptinhalt springen

Import von einer Dateifreigabe in OneDrive for Business mit PowerShell

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 Migrationen von einer Dateifreigabe zu OneDrive for Business zu automatisieren.

Hinweis: Seit Ende Januar 2026 hat Microsoft begonnen, das IDCRL-Cookie schrittweise abzuschaffen. 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 Wichtige Änderung bei der Authentifizierung als „anderer Benutzer" für Microsoft 365.

Voraussetzungen

Hinweis: Sie müssen auf jedem OneDrive Websitesammlungsadmin sein, auch wenn Sie über höhere Administratorrechte verfügen. In Schritt (15) verwenden Sie SharePoint-Admin- oder Globaladmin-Berechtigungen, um Websitesammlungsadmin-Berechtigungen auf alle Ihre OneDrives anzuwenden. Das PowerShell-Skript entfernt die Websitesammlungsadmin-Berechtigungen dann, während Sie jedes OneDrive migrieren.

Anleitung

Tipp: Um Ihre Dokumente in einen neuen Ordner in Ihren OneDrives zu migrieren, siehe Anleitung - Migration in einen neuen OneDrive-Ordner mit PowerShell.

Eine CSV-Anleitung für Ihre Migration erstellen

  1. Erstellen Sie mit diesem Skript eine Liste der Namen aller Verzeichnisse im Ordner DOMAIN:

    dir –Directory Z:\ -Name | Out-File C:\MigrationPlanning\onedrivemigration.csv

    1. Ersetzen Sie die Pfade durch Ihre eigenen.

  2. Öffnen Sie die vom Skript erzeugte CSV-Datei in Excel.

  3. Fügen Sie oben in den Ergebnissen eine neue Zeile für die Überschriften ein.

  4. Benennen Sie die erste Spalte DIRECTORY.

  5. Fügen Sie den zugeordneten Laufwerksbuchstaben vor den Verzeichnisnamen in Ihren Spalten ein (z. B. Z:).

  6. Öffnen Sie ShareGate Migrate.

  7. Gehen Sie zu Alle Berichte.

  8. Klicken Sie oben rechts auf Benutzerdefinierten Bericht erstellen.

  9. Wählen Sie OneDrive for Business als Objekttyp aus.

  10. Klicken Sie auf Fortfahren ohne zu speichern.

  11. Wählen Sie Ihren Mandanten aus.

  12. Klicken Sie auf Ausführen.

  13. Wählen Sie mit dem Kontrollkästchen oben in der Liste alle Ihre OneDrives aus.

  14. Klicken Sie im Menü für Schnellaktionen auf Bearbeiten.

  15. Wählen Sie im Dropdown-Menü Transformationen die Option Administratoren hinzufügen aus.

  16. Suchen Sie im angezeigten Feld Benutzer oder Gruppe auswählen nach Ihrem Konto und fügen Sie es hinzu.

  17. Klicken Sie auf Anwenden.

  18. Klicken Sie zweimal auf Zurück, um zu Ihren Berichtsergebnissen zurückzukehren.

  19. Klicken Sie oben rechts auf Exportieren.

  20. Speichern Sie die Datei auf Ihrem Laufwerk und öffnen Sie sie.

  21. Ersetzen Sie die Überschrift Site-Adresse durch ONEDRIVEURL.

  22. Kombinieren Sie die beiden Tabellen so, dass jedes Verzeichnis in Ihren Zeilen der richtigen URL entspricht.

    Create csv file for OneDrive for Business Migration

    Falls die alphabetische Sortierung nicht funktioniert, können Sie Ihre Daten manuell neu ordnen oder eine Lösung mit Makros oder PowerShell suchen.

  23. Speichern Sie diese neue Datei als CSV auf Ihrem Laufwerk.

Ihr 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:\MigrationPlanning\onedrivemigration.csv"

# Import the CSV file
$table = Import-Csv $csvFile -Delimiter ","

# Define the destination connection
$dstSiteConnection = Connect-Site -Url "https://destinationtenantname-my.sharepoint.com/" -ModernAuth

# Set variables for site and list operations
Set-Variable dstSite, dstList

# Loop through each row in the CSV
foreach ($row in $table) {
    # Clear previous values of variables
    Clear-Variable dstSite
    Clear-Variable dstList

    # Connect to the OneDrive site
    $dstSite = Connect-Site -Url $row.ONEDRIVEURL -UseCredentialsFrom     $dstSiteConnection

    # Get the "Documents" list from the destination site
    $dstList = Get-List -Name Documents -Site $dstSite

    # Import documents from the source folder to the destination list
    Import-Document -SourceFolder $row.DIRECTORY -DestinationList $dstList

    # Remove site collection administrator permissions
    Remove-SiteCollectionAdministrator -Site $dstSite
}

Passen Sie Ihr Skript an Ihre Bedürfnisse an. Hier sind einige Richtlinien:

  • $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 Spalteneinträge trennt. Stellen Sie sicher, dass Ihr Skript dasselbe Trennzeichen wie Ihre Datei verwendet (eine schnelle Möglichkeit, dies zu überprüfen, besteht darin, die CSV-Datei in Notepad zu öffnen).

  • $dstSiteConnection: Ersetzen Sie die URL durch die Stamm-URL Ihrer OneDrives im Zielmandanten.

  • Connect-site: Der Befehl zum Herstellen einer Verbindung mit einer SharePoint-Site oder OneDrive for Business. Wenn Sie die Authentifizierungsmethode von Modern Authentication ändern müssen, siehe Connect Site.

  • -UseCredentialsFrom: Dieses Skript verwendet Modern Authentication mit dem Parameter -UseCredentialsFrom, um eine einzelne Verbindung wiederzuverwenden. Dieses Skript fordert Sie beim Start zur Eingabe Ihrer Microsoft 365-Anmeldeinformationen auf. Wenn MFA für Ihre Mandanten nicht erzwungen wird, können Sie Ihr Skript so einstellen, dass es für die unbeaufsichtigte Planung einen Benutzernamen und ein Kennwort verwendet. Weitere Informationen finden Sie unter Connect-Site und Vermeiden Sie die wiederholte Eingabe Ihrer Anmeldeinformationen bei den Verbindungsmethoden „Browser" und „Modern".

  • Set-Variable und Clear-Variable: Diese Befehle helfen, ein Problem zu vermeiden, bei dem ein Verbindungsfehler dazu führen kann, dass Ihre Daten im falschen OneDrive landen.

  • foreach: Wir verwenden foreach, um die Werte in Ihrer CSV-Datei zu durchlaufen. Weitere Informationen dazu finden Sie hier.

  • Remove-SiteCollectionAdministrator: Entfernt Ihr Benutzerkonto nach der Migration als Websitesammlungsadministrator auf dem OneDrive. Weitere Informationen finden Sie unter Websitesammlungsadministrator entfernen.

Führen Sie Ihr Skript aus, sobald es richtig angepasst und getestet wurde.

Zu beachten

  • Modern Authentication mit -ModernAuth ist die sicherste und beständigste Authentifizierungsmethode und kann mit den Variablen Username und Password verwendet werden, solange die Multi-Faktor-Authentifizierung (MFA) nicht erzwungen wird. Es gibt auch einige Einschränkungen. Siehe Connect-Site, um verschiedene Möglichkeiten zur Verwendung dieser Verbindungsmethode kennenzulernen oder bei Bedarf zur Browser-Authentifizierung zu wechseln.

  • Migrationsberichte werden automatisch erstellt, und Sie finden sie unter Aufgaben. Sie können die Berichte auch mit Export-Report in Ihrem Skript exportieren.

  • Sie können Ihre Migration mit PowerShell planen, um sie außerhalb der Geschäftszeiten auszuführen und die Leistung zu optimieren.

  • Informationen zur Durchführung einer inkrementellen Migration finden Sie im Artikel Inkrementelle Aktualisierung mit PowerShell.

  • Informationen zur Nachbildung der Kopieroptionen aus ShareGate Migrate finden Sie unter Kopieroptionen nachbilden.

  • Wenn Sie Hunderte Gigabyte an Daten zu migrieren haben, 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 Teilmenge von OneDrive-Konten, bevor Sie es umfassend anwenden. Tests helfen dabei, mögliche Probleme in einem kontrollierten Bereich zu erkennen.

Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.

Hat dies deine Frage beantwortet?