Systemanforderungen
- Windows
- 64 Bit (x64), getestet mit Windows 11. Der Agent bringt seine .NET-Laufzeit mit.
- Microsoft 365
- SharePoint Online und OneDrive, Benutzer und Gruppen in Entra ID
- Einrichtung
- ein Global-Admin für die zwei Zustimmungen, danach Global- oder SharePoint-Admin im Portal
- Installation
- erhöht, als Administrator oder per Intune als SYSTEM
- Sync-Laufwerke
- OneDrive-Client, in Windows enthalten
- Stream-Laufwerke
- WinFsp 2.1 auf dem PC (separat, aus der offiziellen Quelle) und Plan Plus. rclone ist im Paket enthalten.
- Version
- Agent 0.2.4, Stand 06.11.2026
Verteilung per Intune, GPO oder RMM
Der Agent braucht zwei Angaben: die Server-Adresse und die Tenant-ID Ihres Microsoft 365. Das Portal zeigt beides mit der fertigen Installationszeile unter «Einrichtung». Eine der drei Varianten genügt.
MSI mit Parametern (RMM, Skript, Intune-LOB)
msiexec /i Wolkenlaufwerk.msi /qn SERVERURL="https://laufwerk.lan-scripts.ch" TENANTID="<Tenant-ID>"
<Tenant-ID> durch die Mandanten-ID aus dem Entra Admin Center ersetzen («Übersicht»).
Intune als Win32-App
- WinFsp als eigene Win32-App, nur für Stream-Laufwerke:
winfsp-2.1.25156.msivon github.com/winfsp/winfsp/releases, Installationmsiexec /i winfsp-2.1.25156.msi /qn, Erkennung über den Registry-WertInstallDirunterHKLM\SOFTWARE\WOW6432Node\WinFsp. - Wolkenlaufwerk als Win32-App aus dem ZIP, WinFsp unter «Abhängigkeiten» mit «automatisch installieren». Installationsbefehl:
powershell -ExecutionPolicy Bypass -File install\install.ps1 -ServerUrl https://laufwerk.lan-scripts.ch -TenantId <Tenant-ID>
Erkennung: Datei C:\Program Files\Wolkenlaufwerk\Wolkenlaufwerk.exe. Optional die Vorlage Wolkenlaufwerk.admx unter «Geräte › Konfiguration › Importieren (ADMX)» hochladen und ein Profil mit Server-Adresse und Tenant-ID zuweisen. Die Richtlinie hat Vorrang vor den Werten aus der Installation.
Gruppenrichtlinie
Wolkenlaufwerk.admx mit den Sprachdateien de-DE und en-US nach C:\Windows\PolicyDefinitions oder in den Central Store kopieren. Unter «Computerkonfiguration › Administrative Vorlagen › Wolkenlaufwerk» die Werte «Server-Adresse» und «Tenant-ID für die Anmeldung» setzen (Schlüssel HKLM\SOFTWARE\Policies\Wolkenlaufwerk). Das MSI selbst per Softwareverteilung oder Startskript.
Skript mit WinFsp
Das Skript im ZIP lädt WinFsp aus der offiziellen Quelle und prüft die Prüfsumme:
powershell -ExecutionPolicy Bypass -File install\install.ps1 -ServerUrl https://laufwerk.lan-scripts.ch -TenantId <Tenant-ID> -WithWinFsp
Ohne Anmeldedialog läuft es auf Entra-verbundenen PCs, sobald Schritt 2 der Zustimmung erteilt ist. Für Sync-Laufwerke zusätzlich die OneDrive-Richtlinie zur stillen Anmeldung mit dem Windows-Konto (SilentAccountConfig) setzen.
Sync oder Stream
Word, Excel und PowerPoint im Team: Sync. Archive und sehr grosse Bibliotheken: Stream. Terminalserver: Stream, Office-Dateien dort mit «Mit Office öffnen» bearbeiten.
| Sync (OneDrive-Synchronisation) | Stream (Netzlaufwerk) | |
|---|---|---|
| Wie | Der OneDrive-Client synchronisiert, der Buchstabe zeigt auf den lokalen Ordner. | Dateien kommen direkt aus Microsoft 365 und werden beim Öffnen geladen. |
| Office | Versionsverlauf bleibt. Gemeinsam bearbeiten mit AutoSave: Rechtsklick «Mit Office öffnen». Doppelklick öffnet die lokale Kopie ohne AutoSave. | Mit «Mit Office öffnen». Direkt auf dem Laufwerk gespeichert entsteht ein neues Dokument ohne Verlauf, das alte landet im Papierkorb. |
| Offline | mit «Dateien bei Bedarf» nach dem ersten Öffnen oder mit «Immer auf diesem Gerät behalten» | nur, was im Zwischenspeicher liegt (Standard 10 GB) |
| Grösse | OneDrive empfiehlt höchstens 300'000 Elemente je Gerät | keine Sync-Grenze |
| Änderungen anderer | über OneDrive | nach rund 1 bis 5 Minuten |
| Im Explorer | unter «Geräte und Laufwerke» | unter «Netzwerkadressen» als \\wolkenlaufwerk\Name |
| Voraussetzung | OneDrive (in Windows enthalten) | WinFsp auf dem PC, Plan Plus |
| Lizenz entzogen | Buchstabe weg, der lokale Sync-Ordner bleibt | Laufwerk weg, wartende Uploads laufen im Hintergrund fertig |
Netzwerk und Firewall
Alle Verbindungen gehen vom PC nach aussen, über HTTPS (TCP 443). Eingehend ist nichts nötig.
| Ziel | Wofür |
|---|---|
laufwerk.lan-scripts.ch | Konfiguration holen, Zustand melden, Installationspaket |
login.microsoftonline.com | Anmeldung bei Microsoft Entra ID |
graph.microsoft.com | Microsoft Graph: Bibliotheken, Kanäle und Dateien auflösen, Stream-Zugriff |
<tenant>.sharepoint.com, <tenant>-my.sharepoint.com | Dateien aus SharePoint, Teams und OneDrive |
| Endpunkte des OneDrive-Clients | für Sync-Laufwerke, laut Microsoft-Liste «Microsoft 365 URLs und IP-Adressbereiche» |
github.com | nur für install.ps1 -WithWinFsp, lädt WinFsp |
Microsoft-Liste: learn.microsoft.com/microsoft-365/enterprise/urls-and-ip-address-ranges
Updates und Deinstallation
Ein neueres MSI über das alte installieren, auch während gearbeitet wird. Der Agent startet sich nach 1 bis 2 Minuten selbst neu, Stream-Laufwerke sind dabei wenige Sekunden weg. Ein Update wartet bis 15 Minuten auf laufende Uploads.
Deinstallieren über «Apps» in Windows oder mit install.ps1 -Uninstall. Synchronisierte Ordner und Benutzerdaten bleiben.
Bekannte Grenzen
- Die Kontextmenü-Befehle stehen im klassischen Menü, unter Windows 11 hinter «Weitere Optionen anzeigen» (Umschalt+F10), und nicht im erhöhten Explorer.
- Je Buchstabe ein Ziel. «Alle meine Teams» in einem Laufwerk und virtuelle Ordner gibt es nicht.
- Auf Stream-Laufwerken keine Sperre «gesperrt durch» zwischen Benutzern. Für gleichzeitiges Bearbeiten «Mit Office öffnen».
- SharePoint erlaubt Pfade bis 400 Zeichen, Windows und Office rechnen mit 260. Office-Links sind auf 256 Zeichen begrenzt (Excel 216), bei längeren öffnet «Mit Office öffnen» den Browser.
- Gelöschtes landet im Papierkorb der SharePoint-Bibliothek, nicht im Windows-Papierkorb.
- Wird ein Sync-Laufwerk entzogen, verschwindet der Buchstabe, die OneDrive-Synchronisation bleibt eingerichtet.
- Nur x64, kein Windows auf ARM.
- Die Programmdateien sind noch nicht signiert. Ein Doppelklick auf das MSI zeigt eine SmartScreen-Warnung, die Verteilung über Intune oder GPO nicht.
- Terminalserver und Azure Virtual Desktop: Agent und Laufwerke laufen je Sitzung, die Benutzerlizenz gilt dort auch. Office-Dateien auf Stream-Laufwerken nur mit «Mit Office öffnen» bearbeiten, sonst geht der Versionsverlauf verloren. Vor dem Einsatz mit der eigenen Umgebung testen.
Meldungen im Tray und was zu tun ist: Anleitung, Abschnitt Mitarbeitende.