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 Ihre Migration von Box.com 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
Berechtigungen als globaler Administrator oder SharePoint-Administrator sind erforderlich.
Sie haben ShareGate Migrate in Box.com autorisiert.
Ihre OneDrives wurden bereitgestellt (dies kann mit dem Get-OneDriveURL-Cmdlet automatisiert werden).
Hinweis: Sie müssen auf jedem OneDrive Websitesammlungsadmin sein, auch wenn Sie über höhere Administratorrechte verfügen. Sie verwenden 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 Box.com-Konto 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.
Weisen Sie sich selbst als Websitesammlungsadministrator auf allen Ihren OneDrives zu
Öffnen Sie ShareGate Migrate.
Gehen Sie zu Alle Berichte.
Klicken Sie oben rechts auf Benutzerdefinierten Bericht erstellen.
Wählen Sie OneDrive for Business als Objekttyp aus.
Klicken Sie auf Fortfahren ohne zu speichern.
Wählen Sie Ihren Mandanten aus.
Klicken Sie auf Ausführen.
Wählen Sie mit dem Kontrollkästchen oben in der Liste alle Ihre OneDrives aus.
Klicken Sie im Menü für Schnellaktionen auf Bearbeiten.
Wählen Sie im Dropdown-Menü Transformationen die Option Administratoren hinzufügen aus.
Suchen Sie im angezeigten Feld Benutzer oder Gruppe auswählen nach Ihrem Konto und fügen Sie es hinzu.
Klicken Sie auf Anwenden.
Ihr Skript erstellen
Kopieren Sie das folgende Skript und fügen Sie es in die PowerShell-Anwendung Ihrer Wahl ein.
Import-Module Sharegate
# Connect to Box
$box = Connect-Box -Email [email protected] -Admin
# Get all Box users
$users = Get-BoxUsers -Box $box
# Connect to the SharePoint tenant
$tenant = Connect-Site -Url https://mytenant-admin.sharepoint.com -ModernAuth
# Loop through each user
foreach ($user in $users) {
# Check if the user is not inactive
if ($user.Status -ne 'inactive') {
# Get the user's OneDrive site URL
$dstSiteUrl = Get-OneDriveUrl -Tenant $tenant -Email $user.Email
# Connect to the user's OneDrive site
$dstSite = Connect-Site -Url $dstSiteUrl -UseCredentialsFrom $tenant
# Get the "Documents" list from the user's OneDrive site
$dstList = Get-List -Site $dstSite -Name "Documents"
# Import documents from Box to the OneDrive "Documents" list
Import-BoxDocument -Box $box -DestinationList $dstList -UserEmail $user.Email
# Remove site collection administrator permissions
Remove-SiteCollectionAdministrator -Site $dstSite
}
}
Passen Sie Ihr Skript an Ihre Bedürfnisse an. Hier sind einige Richtlinien:
$box: Ersetzen Sie die E-Mail-Adresse durch Ihre Box.com-Admin-E-Mail-Adresse.
$tenant: Ändern Sie die URL entsprechend dem Admin Center Ihres Mandanten.
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.
foreach: Wird verwendet, um eine Reihe von Werten zu durchlaufen. In diesem Fall werden alle Befehle zwischen den foreach-Klammern für jeden Benutzer in Ihrem Box.com-Konto wiederholt.
-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 Ihren 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".
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 für Microsoft 365 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.
Sie können den Inhalt des Stammordners Ihres Benutzers in Box.com migrieren, aber nicht den Ordner selbst. Wenn Sie Box.com-Inhalte in einen separaten Ordner in OneDrive for Business migrieren möchten, müssen Sie diesen Zielordner zuerst erstellen.
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 in PowerShell.
Nur die Dateien, die dem Benutzer gehören, werden migriert. Wenn der Benutzer Mitbearbeiter oder Miteigentümer einer Datei ist, wird diese während der Migration nicht kopiert.
Wenn Sie erhebliche Leistungsprobleme feststellen, siehe Box.com-Drosselung.
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.