Zum Hauptinhalt springen

Erstellen eines neuen Teams-Ordners für Migrationen 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.

Mit dieser Anleitung können Sie einen neuen Ordner auf der Registerkarte „Dateien" Ihres allgemeinen Teams-Kanals bereitstellen, bevor Sie Ihr Migrationsskript ausführen.

Voraussetzungen

  • Sie verfügen über die Berechtigungen als globaler Administrator oder SharePoint-Administrator.

  • Sie sind in Explorer mit Ihrem Microsoft 365 Admin Center verbunden.

  • Ihre Teams wurden bereitgestellt.

Hinweis: Sie müssen auf jeder Team-Website Websitesammlungsadmin sein, selbst wenn Sie über höhere Administratorrechte verfügen. Ihr Skript enthält den Befehl Add-SiteCollectionAdministrator, um die für die Erstellung jedes Ordners erforderlichen Websitesammlungsadmin-Berechtigungen anzuwenden. Die hinzugefügten Berechtigungen werden anschließend mit dem Befehl Remove-SiteCollectionAdministrator wieder entfernt.

Skriptvorbereitung

Erstellen Sie mit den folgenden Schritten einen Ordner auf Ihrem lokalen Laufwerk sowie eine CSV-Liste aller Ihrer Teams-Websites:

  1. Erstellen Sie auf Ihrem lokalen Laufwerk einen neuen Ordner.

  2. Benennen Sie den Ordner nach Belieben, passend zu Ihrem allgemeinen Teams-Ordner (z. B. C:\Migrated data).
    Notieren Sie sich den Pfad des Ordners.

  3. Gehen Sie in ShareGate Migrate über die Seitenleiste zu All reports.

  4. Klicken Sie oben rechts auf Create custom report.

  5. Wählen Sie Microsoft 365 group als Objekttyp aus.

  6. Wählen Sie unter Filters die Option Is team connected Is Yes aus.

  7. Fügen Sie unter Columns die Option Associated site address zur Liste Selected Columns hinzu.

  8. Klicken Sie auf Continue without saving.

  9. Wählen Sie Ihren Mandanten aus und klicken Sie dann auf Next.

  10. Klicken Sie auf Run now.

  11. Aktivieren Sie das Kontrollkästchen oben in der Liste, um alle im Bericht enthaltenen Teams auszuwählen.

  12. Klicken Sie oben rechts auf Export.

  13. Speichern Sie die Datei, öffnen Sie sie in Excel und führen Sie Folgendes aus:

    • Löschen Sie die Spalten Display name, Email address und Is team connected.

    • Benennen Sie die Spalte „Associated site address" in SITEURL um.

  14. Speichern Sie diese Datei als CSV-Datei auf Ihrem lokalen Laufwerk (z. B. C:\foldermigration.csv).
    Notieren Sie sich den Pfad der CSV-Datei.

Skript erstellen

# Define the CSV file path
$csvFile = "C:\foldermigration.csv"

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

# Define credentials
$MyPassword = ConvertTo-SecureString 'My password' -AsPlainText -Force
$MyUsername = "My username"

# 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 site
    $dstSite = Connect-Site -Url $row.SITEURL -UserName $MyUsername -Password $MyPassword 

    # Add site collection administrator
    Add-SiteCollectionAdministrator -Site $dstSite

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

    # Import documents to the "General" folder in the destination list
    Import-Document -SourceFilePath "C:\Migrated data" -DestinationList $dstList -DestinationFolder "General"

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

Passen Sie Ihr Skript so an, dass es für Sie funktioniert. Hier sind einige Richtlinien:

  • $csvFile: Passen Sie den Pfad an, sodass er auf die zuvor gespeicherte CSV-Datei verweist.

  • $table: Das Trennzeichen ist das Symbol, das die Elemente in einer Zeile Ihrer CSV-Datei 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 mit dem Editor).

  • $MyPassword und $MyUsername: Ersetzen Sie 'My password' und "My username" durch Ihre Microsoft 365-Anmeldedaten.

  • Connect-site: Der Befehl zum Herstellen einer Verbindung mit einer SharePoint-Website. Wenn Sie die Authentifizierungsmethode ändern müssen, siehe Website verbinden. Um die Browserauthentifizierung zu verwenden, siehe Anmeldeinformationen einer vorherigen Browserverbindung verwenden.

  • Set-Variable und Clear-Variable: Diese Befehle helfen, ein Problem zu vermeiden, bei dem ein Verbindungsfehler das Kopieren Ihres Ordners verhindern kann.

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

  • -SourceFilePath: Ersetzen Sie "C:\Migrated data" durch den Ordnerpfad, den Sie in Schritt (2) erstellt haben.

  • Add-SiteCollectionAdministrator: Fügen Sie Ihr Benutzerkonto vor der Migration als Websitesammlungsadministrator hinzu. Weitere Informationen finden Sie unter Websitesammlungsadministrator hinzufügen.

  • Remove-SiteCollectionAdministrator: Entfernen Sie Ihr Benutzerkonto nach der Migration als Websitesammlungsadministrator. Weitere Informationen finden Sie unter Websitesammlungsadministrator entfernen.

Führen Sie Ihr Skript aus, nachdem es ordnungsgemäß angepasst und getestet wurde.

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

Hat dies deine Frage beantwortet?