Synchronisierten SharePoint Ordner über PowerShell trennen

In den meisten Fällen kann für einen synchronisierter SharePoint Ordner im OneDrive Sync Client die Synchronisierung gestoppt werden. Eventuell siehst du bei dir noch die alte Version des Sync Clients.

Synchronisierung von Ordnern stoppen
Synchronisierung von Ordnern stoppen

In einzelnen Fällen, oder wenn sehr viele Ordner synchronisiert werden, kann der Sync Client mit der Anzeige überlastet sein. In so einem Fall könnte die Abbildung in der Art aussehen.

Fehlende Angaben zur Synchronisierung
Fehlende Angaben zur Synchronisierung

Die Möglichkeiten für Stoppen von Sync fehlen. In den Dokumentationen von Microsoft fand ich bisher keine Hinweise über ein Limit an synchronisierten Ordnern.
Der Status signalisiert am lokalen Client sind die Ordner weiterhin im Sync. In dem Status synchronisiert der Client jede Anpassung in die Cloud.

Lokaler Sync Status
Lokaler Sync Status

Möchte jemand nicht mehr benötigte, aber im Sync befindliche Ordner aufräumen, ist die Trennung nicht mehr möglich.
Im ersten Schritt wird empfohlen einen Reset des OneDrive Clients durchzuführen. In vielen Fällen wird auch Microsoft Support dazu raten. Bei einem Reset sah ich jedoch auch unerwartete Nebeneffekte, ausserdem startet die Synchronisation nach dem Reset neu und kann lange dauern.

Ich schrieb mit Disconnect-TAOneDriveSyncedFolder ein Command um ausgewählte, lokal synchronisierte Ordner über PowerShell zu trennen. Falls möglich bereinigt das Command ausserdem verwaiste Einträge.

PowerShell
Disconnect-TAOneDriveSyncedFolder -Foldername "TAM365 Demo - AlexW Private Channel - AlexW Private Channel"


Folgende Hinweise solltest du beachten:

  1. Beschreibung und das Command Disconnect-TAOneDriveSyncedFolder findest du in meinem GitHub Repository.
  2. Während der Anpassung werden alle Instanzen der Sync Clients beendet.
  3. Der OneDrive Sync Client speichert seine Konfiguration in einer Config-Datei in deinem persönlichen AppData-Ordner. Das Script passt am Ende die Datei an, erstellt davor aber ein Backup der bestehenden Datei.
Backup der OneDrive Sync Config-Datei
Backup der OneDrive Sync Config-Datei
  1. Das Script bereinigt Einträge in der Registry. Sind die Informationen noch in der Config-Datei aus Punkt 3, dann erstellt der Sync Client die Registry Einträge neu. Bei Problemen könntest du das Backup der Datei zurückspielen, den OneDrive Sync Client neu starten und es erstellt die fehlenden Einträge wieder.

An folgenden Orten speichert der OneDrive Sync Client zum aktuellen Zeitpunkt Informationen über seine synchronisierten Ordner.

  • C:\Users\<Username>\AppData\Local\Microsoft\OneDrive\settings\<SyncInstance>\<Guid>.ini
  • HKCU:\SOFTWARE\Microsoft\OneDrive\Accounts\<SyncInstance>\ScopeIdToMountPointPathCache\<RandomLibraryID>
  • HKCU:\SOFTWARE\SyncEngines\Providers\OneDrive\<RandomLibraryID>
  • HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\SyncRootManager\OneDrive!<UserSID>!<SyncInstance>|<RandomLibraryID>
  • HKU:\<UserSID>\SOFTWARE\Microsoft\OneDrive\Accounts\<SyncInstance>\ScopeIdToMountPointPathCache\<RandomLibraryID>
  • HKU:\<UserSID>\SOFTWARE\Microsoft\OneDrive\Accounts\<SyncInstance>\Tenants\<SyncTenant>\<LocalSyncFolderPath>
  • HKU:\<UserSID>\SOFTWARE\SyncEngines\Providers\OneDrive\<RandomLibraryID>
  1. Nach Bereinigung wird der zuvor synchronisierte Ordner aus der Config-Datei entfernt.
  2. OneDrive Sync Client wird neu gestartet.
  3. Nach dem Start ist der bereinigte Ordner nicht mehr im Sync. Der Ordner kann nun lokal gelöscht werden.
Synchronisierung für AlexW Private Channel Ordner beendet
Synchronisierung für AlexW Private Channel Ordner beendet

Du könntest einen Sync für den Ordner zu einem späteren Zeitpunkt wieder über den gewohnten Weg einrichten.

Share
Avatar photo

Tobias Asböck

Tobias is a Senior System Engineer with more than 10 years of professional experience with Microsoft 365 products such as SharePoint Online, SharePoint Premium, OneDrive for Business, Teams Collaboration, Entra ID, Information Protection, Universal Print, and Microsoft 365 Licensing. He also has 15+ years of experience planning, administering, and operating SharePoint Server environments. Tobias is a PowerShell Scripter with certifications for Microsoft 365 products. In his spare time, Tobias is busy with updates in the Microsoft 365 world or on the road with his road bike and other sports activities. If you have additional questions, please contact me via LinkedIn or [email protected].

Leave a Reply

Your email address will not be published. Required fields are marked *