OneDrive „Dateien bei Bedarf“ und Geschäftsanwendungen — welche Annahmen Platzhalter zerbrechen

„Eine Geschäftsanwendung kann eine CSV nicht lesen, die ich auf dem Desktop gespeichert habe.“ „Nach dem PC-Tausch bleibt der Import, der bisher funktionierte, mit ‚Datei nicht gefunden‘ stehen.“ Weil der Explorer die Datei zeigt, kommt man durch erneutes Speichern oder Neustart der App manchmal der Ursache nicht näher.

Dann lohnt es, den Ort der Datei und ob der Inhalt lokal vorliegt getrennt zu prüfen. OneDrives Known Folder Move (KFM) ändert den Ort von Desktop und ähnlichen Ordnern, und Dateien bei Bedarf lässt den Inhalt in der Cloud, bis er gebraucht wird. Beides wird zum Problem, wenn eine Geschäftsanwendung eine herkömmliche lokale Datei voraussetzt.¹²

Dieser Artikel richtet sich an IT-Verantwortliche in kleinen und mittleren Unternehmen und an Entwicklerinnen und Entwickler von Windows-Apps. Zuerst folgt ein Verfahren zur Eingrenzung solcher Anfragen. Danach erklärt er, wie Platzhalter funktionieren und wie man ihre Attribute liest, welche Fallen Geschäftsanwendungen treffen, und was Entwicklungs- und IT-Seite jeweils tun können.

1. Zuerst das Fazit — Ort und Inhalt getrennt prüfen

Dass eine Datei im Explorer sichtbar ist, garantiert weder, dass die App den richtigen Pfad ansieht, noch dass der Inhalt sofort lesbar ist. Trennen Sie zuerst die folgenden zwei Fragen.

Pfade, die KFM verschoben hat, holen Sie über die APIs für bekannte Ordner. Bei Dateien bei Bedarf prüfen Sie zuerst die Attribute und öffnen nur Dateien, deren Inhalt Sie brauchen. Dateien bei Bedarf ist in der aktuellen Synchronisierungs-App standardmäßig aktiv, und Microsoft empfiehlt, es aktiv zu lassen. Ein Problem ist kein Grund, es von vornherein überall abzuschalten.¹³⁴

Der Notbehelf ist, die für das Geschäft nötigen Ordner auf „Immer auf diesem Gerät behalten“ zu setzen, damit der Inhalt lokal vorliegt. Einen falschen Pfad zu korrigieren ist jedoch eine eigene Aufgabe. Die dauerhafte Lösung: die App-Seite überprüft Speicherort, Lesevorgang und Überwachung, die IT-Seite hält den nötigen Zustand mit Anheften und Richtlinie.

In der Abbildung kennzeichnet eine durchgezogene Linie eine stets geltende Beziehung und eine gestrichelte Linie eine bedingte (die Bedingungen stehen bei jeder Beziehung auf der Detailseite). Die vollständige Liste der Beziehungen (16 insgesamt, mit Beleg und Sicherheitsgrad) und die Definitionen der wichtigsten Konzepte sind auf der Detailseite der Wissenskarte (auf Japanisch) zusammengestellt. Daten: JSON-LD / Turtle

2. Eingrenzung, wenn jemand meldet, die Datei lasse sich nicht lesen

2.1. Sechs Punkte der Reihe nach, beginnend beim Pfad

Öffnen Sie nicht sofort alle Dateien des Zielordners; untersuchen Sie Pfad und Metadaten. Das Verfahren trennt Existenzprüfung und Lesen.

Je nachdem, ob privates oder geschäftliches OneDrive genutzt wird, sind auch die Umgebungsvariablen OneDrive / OneDriveCommercial ein Hinweis. Urteilen Sie nicht allein nach dem Anzeigenamen „Desktop“; gleichen Sie mit dem Pfad ab, den die App tatsächlich angesprochen hat.

Liegt der Pfad nicht unter OneDrive und ist auch kein Platzhalter, bleiben Sie nicht bei OneDrive stehen und prüfen Sie freigegebene Ordner, Pfadlänge und Ähnliches. „Fallstricke von Netzlaufwerken und UNC-Pfaden“ und „MAX_PATH und Fallstricke von Windows-Pfaden und Dateinamen“ ordnen andere Ursachen.

2.2. Notbehelf und die Prüfung, ob die Arbeit weitergehen kann, trennen

Wenn der Inhalt einer nur-online-Datei nicht lesbar ist, klicken Sie den Zielordner mit der rechten Maustaste an und wählen „Immer auf diesem Gerät behalten“. Beim Umschalten per Skript nehmen Sie etwa attrib +p -u <Ordner> /s /d, damit das Anheften zugleich das Nicht-Anheften-Attribut entfernt.⁶⁷

Was hier zu prüfen ist, ist nicht, dass die Aktion ausgeführt wurde, sondern dass der Download der nötigen Dateien abgeschlossen ist und sie lesbar sind. Anheften ist ein Attribut, das die Absicht ausdrückt, lokal zu halten; es behebt nicht Stopp von OneDrive, Netzstörung oder knappen Speicher. Prüfen Sie den Zustand der Synchronisierungs-App und den Inhalt der Zieldateien, bevor Sie den Import erneut starten.³⁶

Nach der Wiederherstellung gehen Sie bei festem Pfad oder Datenablage zu den App-Maßnahmen in Kapitel 6, bei lokalem Inhalt oder uneinheitlichen Geräteeinstellungen zu den IT-Maßnahmen in Kapitel 7. Dass es nach dem Anheften einmal lief, und dass ein Entwurf da ist, der nicht wiederkehrt, sind zwei verschiedene Dinge.

3. Was sich geändert hat — KFM und die Mechanik der Platzhalter

3.1. KFM ändert den realen Pfad von Desktop und ähnlichen Ordnern

KFM (Known Folder Move) ist die Funktion, die in den OneDrive-Einstellungen als „Sicherung“ oder „Wichtige Ordner sichern“ erscheint. Ist sie aktiv, wandern Desktop, Dokumente und Bilder unter OneDrive. Die folgende Tabelle zeigt Beispiele für Pfade. Ordnernamen und Synchronisierungswurzel unterscheiden sich je nach Umgebung; betten Sie diese Zeichenfolgen nicht unverändert in Code ein.¹

Bei der Ersteinrichtung eines neuen PCs (OOBE) kann nach der Anmeldung mit Microsoft-Konto oder Arbeitskonto eine Sicherung vorgeschlagen und unmittelbar aktiviert werden. In Organisationen kann die Richtlinie KFMSilentOptIn die Verschiebung ohne Benutzeraktion flächendeckend auslösen. Gehen Sie nicht davon aus, dass nur bewusst gesetzte Einstellungen gelten.¹⁸

Unangenehm ist, dass sich das Aussehen des Explorers kaum ändert. Apps, die SHGetKnownFolderPath oder .NETs Environment.GetFolderPath nutzen, erhalten den Pfad nach dem Umzug. Apps, die einen festen Pfad wie C:\Users\%USERNAME%\Desktop in Einstellungsdatei oder Code eingebettet haben, suchen weiter am alten Ort.

Das heißt: die Anpassung an KFM ist zuerst ein Problem der Pfadauflösung. Erst wenn der richtige Pfad nach dem Umzug bekannt ist, prüfen Sie, ob der Inhalt lokal vorliegt.

3.2. Dateien bei Bedarf trennt „sichtbar sein“ von „Inhalt haben“

Ist Dateien bei Bedarf aktiv, können synchronisierte Dateien im Explorer erscheinen, ohne dass der Inhalt heruntergeladen wird, bis er gebraucht wird. Auch Dateien, die auf einem anderen Gerät oder im Web entstanden, erscheinen als nur-online-Platzhalter.²⁴

Den Zustand erkennt man an den Symbolen im Explorer.⁹

Wichtig ist: „lokal verfügbar“, weil die Datei einmal geöffnet wurde, und „Immer auf diesem Gerät behalten“ nach dem Anheften sind nicht dasselbe. Ersteres kann durch die Aktion „Speicherplatz freigeben“ des Benutzers oder durch Speicheroptimierung wieder nur online werden. „Letzten Monat ließ es sich lesen“ belegt nicht, dass der Inhalt diesmal noch da ist.²¹⁰

stateDiagram-v2
    accTitle: Die drei Zustände von Dateien bei Bedarf und die Übergänge
    accDescr: Eine nur-online-Datei wird durch Öffnen lokal verfügbar, kehrt durch Speicherplatz freigeben oder Speicheroptimierung zu nur online zurück, und nur angeheftete Dateien sind von der automatischen Freigabe ausgenommen
    s1: Nur online (Wolkensymbol)
    s2: Lokal verfügbar
    s3: Angeheftet (Immer auf diesem Gerät behalten)
    s1 --> s2: Öffnen (Hydration)
    s2 --> s1: Speicherplatz freigeben
    s2 --> s1: Speicheroptimierung
    s1 --> s3: Immer auf diesem Gerät behalten
    s2 --> s3: Immer auf diesem Gerät behalten
    s3 --> s2: Anheften aufheben

Abbildung 1: Eine Datei, die nur einmal heruntergeladen wurde, kann anders als eine angeheftete Datei Ziel automatischer Freigabe sein.

3.3. Beim Lesen holt die Cloud Files API den Inhalt nach

Dateien bei Bedarf ist auf der mit Windows 10 Version 1709 eingeführten Cloud Files API aufgebaut. Auf der Dateisystemseite arbeitet der Minifilter cldflt.sys (Dienstname CldFlt, Windows Cloud Files Filter Driver); OneDrive ist einer der Synchronisierungsanbieter, die diese API nutzen.¹¹⁶

Ein Platzhalter, der den Inhalt noch nicht hat, ist ein Analysepunkt mit Metadaten wie Dateiname, Größe und Zeitstempel. Nach Microsofts Beschreibung braucht die Speicherung des Dateisystemheaders etwa 1 KB. Versucht eine App, den Inhalt zu lesen, fordert der Minifilter den Synchronisierungsanbieter zur Datenübertragung auf, und das Lesen geht weiter, sobald die nötigen Daten da sind. Dieses Nachladen heißt Hydration, das Freigeben des lokalen Inhalts und die Rückkehr zum Platzhalter Dehydration.¹¹

sequenceDiagram
    accTitle: Hydration beim Öffnen eines Platzhalters
    accDescr: Öffnet und liest eine App einen Platzhalter, erkennt der Minifilter cldflt.sys die Anforderung, weist den Synchronisierungsanbieter zur Datenübertragung an und lässt das Lesen nach Abschluss des Downloads weiterlaufen
    participant app as Geschäftsanwendung
    participant flt as Minifilter cldflt.sys
    participant sync as Synchronisierungsanbieter
    app->>flt: Öffnen und Leseanforderung
    flt->>sync: Datenübertragung anweisen
    sync-->>flt: Download abgeschlossen
    flt-->>app: Lesen läuft weiter

Abbildung 2: Mitten in einem Lesevorgang, der wie eine lokale Datei aussieht, liegt ein Download durch den Synchronisierungsanbieter.

Die Cloud Files API verbirgt aus Kompatibilitätsgründen allen Prozessen außer der Synchronisierungs-Engine und denen unter %systemroot%, dass es sich um einen Analysepunkt handelt. Deshalb sieht eine gewöhnliche App „eine normale Datei, die nur etwas langsamer öffnet“. Urteilen Sie nicht allein mit Code, der Analysepunkte besonders behandelt; prüfen Sie die Attribute im nächsten Kapitel.¹¹ Die Mechanik der Analysepunkte selbst erklärt „NTFS-Interna“.

In den Eigenschaften des Explorers erscheint unter „Größe“ die eigentliche Dateigröße, während „Größe auf dem Datenträger“ nahezu 0 ist. Dass ein Dateiname da ist und eine Größe ermittelt werden kann, und dass der Inhalt lokal vorliegt, sind zwei verschiedene Dinge.

4. Den Zustand an Dateiattributen prüfen

4.1. Zustand des Inhalts und Absicht, ihn zu halten, getrennt lesen

Der Zustand eines Platzhalters wird als gewöhnliches Dateiattribut veröffentlicht. Die wichtigsten Attribute sind die folgenden.³

OFFLINE und RECALL_ON_DATA_ACCESS sind Hinweise darauf, ob Daten sofort nutzbar sind. PINNED / UNPINNED dagegen drücken die Absicht aus, lokal zu halten. Urteilen Sie nicht allein an P oder U, ob der Download abgeschlossen ist. Außerdem erscheint RECALL_ON_OPEN in den Ergebnissen einer Verzeichnisauflistung und ist nicht über jede API zur Attributabfrage gleichermaßen zu erhalten.³

4.2. Beim Prüfen und Ändern mit attrib auf die Reihenfolge des Umschaltens achten

Mit attrib <Pfad> können Sie Attribute prüfen. O steht für offline, P für angeheftet, U für nicht angeheftet. Microsoft ordnet die Zustände von OneDrive und die Setzbefehle wie folgt.⁷⁶

Führen Sie auf einer nur-online-Datei (U) nur attrib -p aus, bleibt U stehen und der Inhalt wird nicht geholt. Auch wenn Sie „lokal verfügbar“ wollen, brauchen Sie die Reihenfolge zuerst +p für „immer verfügbar“, damit heruntergeladen wird, danach -p. Skripte, die einen bestehenden Zustand umschalten, entfernen mit attrib +p -u auch das gegenteilige Attribut.⁶

4.3. Den Zustand von CSV-Dateien mit PowerShell gesammelt prüfen

Attribute einer Datei zu lesen, löst keine Hydration des Inhalts aus. Das folgende Beispiel holt den Pfad von Dokumente über die API für bekannte Ordner und prüft die Attribute der CSV-Dateien.

function Test-CloudPlaceholder {
    param([Parameter(Mandatory)][string]$Path)

    $value = [int](Get-Item -LiteralPath $Path -Force).Attributes

    [pscustomobject]@{
        Path               = $Path
        Offline            = ($value -band 0x00001000) -ne 0  # FILE_ATTRIBUTE_OFFLINE
        RecallOnDataAccess = ($value -band 0x00400000) -ne 0  # Inhalt liegt nicht vollständig lokal
        Pinned             = ($value -band 0x00080000) -ne 0  # Immer auf diesem Gerät behalten
        Unpinned           = ($value -band 0x00100000) -ne 0  # Nur online
    }
}

# CSV-Dateien unter Dokumente gesammelt prüfen (Inhalt wird nicht heruntergeladen).
# Den Pfad über die API für bekannte Ordner auflösen. Den Anzeigenamen
# "Dokumente" fest einzutippen ergibt in Umgebungen mit englischem Ordnernamen
# (Documents) oder je nach KFM-Konfiguration einen nicht existierenden Pfad
Get-ChildItem ([Environment]::GetFolderPath('MyDocuments')) -Recurse -Filter *.csv |
    ForEach-Object { Test-CloudPlaceholder $_.FullName } |
    Where-Object RecallOnDataAccess |
    Format-Table -AutoSize

Die Umwandlung nach [int] ist nötig, weil die .NET-Enumeration FileAttributes Namen wie RECALL_ON_DATA_ACCESS nicht definiert. Sie wandeln in eine Zahl und prüfen bitweise. Wichtig sind beides: den Anzeigenamen „Dokumente“ nicht fest einzutippen, und Attribute zu lesen, ohne den Inhalt zu lesen.

5. Sechs Probleme, die in Geschäftsanwendungen sichtbar werden

Ein Platzhalter ist keine beschädigte Datei. Er verträgt sich jedoch schlecht mit Annahmen wie „eine existierende Datei lässt sich sofort lesen“ oder „lokale Überwachungsereignisse stammen von Benutzeraktionen“.

5.1. Die Existenzprüfung gelingt, das Lesen scheitert

Auch bei einer nur-online-Datei können eine Existenzprüfung wie File.Exists() und das Holen von Attributen und Größe gelingen. Sobald der Inhalt gelesen wird, ist Hydration nötig; Stopp, Abmeldung oder Pause von OneDrive sowie Netzstörungen erscheinen dann als Lesefehler. Bei großen Dateien kann das Warten auf den Download zum Timeout der App werden.

Zu den Cloud-Datei-Fehlern gehört 0x8007016A zu ERROR_CLOUD_FILE_PROVIDER_NOT_RUNNING („Der Cloud-Dateianbieter wird nicht ausgeführt“). Fassen Sie das nicht als „Datei fehlt“ zusammen; zeichnen Sie den ursprünglichen Fehlercode und den Zielpfad auf.⁵

5.2. Stapelverarbeitung löst den Download von allem aus

Richten Sie einen Stapel, der alle Dateien eines Ordners liest, Hashberechnung, Volltextsuche oder eine eigene Sicherung auf einen Ordner unter OneDrive, folgt Hydration jeder gelesenen Datei. Bei einem Ordner von mehreren GB steigen nicht nur die Laufzeit, sondern auch Netzverkehr und lokaler Datenträgerverbrauch. Auf PCs mit knappem Speicher führt das zu weiteren Ausfällen durch fehlenden Platz.

Holt eine App Dateien nach, die der Benutzer nicht ausdrücklich geöffnet hat, kann Windows benachrichtigen und dem Benutzer die Wahl zum Blockieren geben. Wird dort blockiert, scheitern spätere Downloads dieser App. Aufgehoben wird das unter „Automatischer Dateidownload“ in den Einstellungen. Wenn „nur ein bestimmter PC scheitert“, prüfen Sie auch diesen Zustand.¹¹

5.3. Code, der zusätzliche Attribute nicht erwartet, urteilt falsch

Eine Prüfung auf exakte Übereinstimmung wie attributes == FileAttributes.Archive schließt Dateien mit weiteren Attributen als „unvorhergesehen“ aus. Sicherungs- oder Synchronisierungswerkzeuge interpretieren OFFLINE manchmal als „auf Band ausgelagert“ und überspringen, oder sie holen umgekehrt auch unnötige Dateien nach. Auch beim Prüfen auf schreibgeschützt oder beim Ändern des Archivbits darf die Kombination der übrigen Attribute nicht zerbrochen werden.

Die Microsoft-Hinweise für Minifilter warnen davor, an Dateien mit RECALL_ON_DATA_ACCESS unbedacht zu lesen oder zu schreiben. Einschränkungen für Kerneltreiber und die Implementierung im Benutzermodus sind nicht identisch, aber dass das Berühren des Inhalts Nachladekosten erzeugt, müssen auch Geschäftsanwendungen im Blick behalten.¹²

5.4. FileSystemWatcher fängt auch die Aktivität der Synchronisierung

Überwachen Sie einen Ordner unter OneDrive mit FileSystemWatcher, können Ereignisse nicht nur von Benutzeraktionen kommen, sondern auch von der Synchronisierung von Änderungen anderer Geräte und von Attribut- oder Größenupdates durch Hydration und Dehydration.

Schreiben Sie das Importresultat in denselben Ordner zurück, entsteht eine Schleife aus Schreiben, Upload, Attributupdate und erneutem Ereignis.

flowchart TB
    accTitle: Schleife der Änderungsbenachrichtigungen durch Überwachung und Zurückschreiben
    accDescr: Schreibt eine überwachende App das Importresultat in denselben Ordner zurück, erzeugen Upload und Attributupdate der Synchronisierungs-App erneut Ereignisse und werden zur Sturmflut von Änderungsbenachrichtigungen
    ev["Änderungsereignis"] --> proc["Überwachungs-App importiert"]
    proc --> write["Zurückschreiben in denselben Ordner"]
    write --> up["Synchronisierungs-App lädt hoch"]
    up --> attr["Attribute oder Größe werden aktualisiert"]
    attr --> ev
    sync["Synchronisierung von Änderungen anderer Geräte"] -.-> ev

Abbildung 3: Schreiben Sie das Importresultat an das überwachte Ziel zurück, können auch die Aktivitäten der Synchronisierungs-App die Benachrichtigungen wiederholen.

Warum Ereignisse gedrosselt und der Inhalt bestätigt werden müssen, behandelt „Praxisleitfaden für FileSystemWatcher“. Unter OneDrive ist es noch wichtiger, eine Benachrichtigung nicht ungeprüft als „eine importierbare Datei ist angekommen“ zu lesen.

5.5. Exklusivsperren und Bearbeitung auf mehreren PCs kollidieren mit der Synchronisierung

Solange eine Geschäftsanwendung eine Datei mit Exklusivsperre geöffnet hält, kann die Synchronisierungs-App sie nicht hochladen oder aktualisieren. Entwürfe, die Access-.accdb, eigene Datendateien oder Protokolle lange offen halten, machen Synchronisierungsfehler unter OneDrive zum Dauerzustand.

Bearbeiten mehrere PCs dieselbe Datei, können Konfliktkopien mit PC-Namen oder „Kopie von …“ entstehen, damit beide Fassungen bleiben. Ein Import, der „ein Ordner, eine Datei“ voraussetzt, gerät durch diese Duplikate ins Straucheln. Zum Sperrentwurf siehe auch „Grundlagen des wechselseitigen Ausschlusses bei der Dateiintegration“.

5.6. Scans und der Suchindexer holen den Inhalt ebenfalls nach

Nicht nur die Geschäftsanwendung liest den Inhalt. Ein vollständiger Virenscan oder der Suchindexer löst Hydration aus, sobald er den Inhalt eines Platzhalters berührt.

Der Planungsleitfaden zu Azure File Sync erklärt, dass Microsoft Defender und Ähnliches Dateien mit RECALL_ON_DATA_ACCESS beim On-Demand-Scan überspringen. Das ist jedoch eine Entscheidung des jeweiligen Produkts; nicht jedes Sicherheitsprodukt geht gleich vor. Wenn „bei jedem Nachtscan Netz und Datenträger feststecken“ oder „am Morgen alle nur-online-Dateien wieder Inhalt haben“, untersuchen Sie auch das Verhalten der Scan-Seite.¹³

6. Maßnahmen der App-Entwicklung — nicht unbedacht öffnen, den Speicherort trennen

6.1. Bei der Auflistung Attribute prüfen und nur Dateien lesen, deren Inhalt nötig ist

Die Grundlinie ist, einen Platzhalter als „Datei mit Nachladekosten“ zu behandeln. Nicht zwingende Verarbeitung wie Protokollerfassung, Hashberechnung oder Vorschau soll die Möglichkeit haben, solche Dateien zu überspringen.

Das folgende Beispiel prüft die Attribute, bevor eine CSV importiert wird.

// Werte, die FileAttributes in .NET nicht definiert, als Zahlen festlegen
const FileAttributes RecallOnDataAccess = (FileAttributes)0x00400000;
const FileAttributes RecallOnOpen       = (FileAttributes)0x00040000;

static bool IsCloudPlaceholder(FileAttributes attributes) =>
    (attributes & (RecallOnDataAccess | RecallOnOpen | FileAttributes.Offline)) != 0;

foreach (var file in new DirectoryInfo(watchFolder).EnumerateFiles("*.csv"))
{
    if (IsCloudPlaceholder(file.Attributes))
    {
        log.Warn($"{file.Name} ist nur online, diesmal wird sie übersprungen");
        continue;
    }
    Import(file.FullName);
}

Dieses Beispiel folgt der Linie, Dateien, die nur online sein können, in diesem Lauf nicht zu verarbeiten. Dateien, die das Geschäft zwingend importieren muss, dürfen nicht allein durch eine Warnung im Protokoll als erledigt gelten. Legen Sie zusammen fest, wie der Inhalt vorher sichergestellt wird und wie Lesefehler behandelt werden.

6.2. FILE_FLAG_OPEN_NO_RECALL nicht als Garantie ohne Netzverkehr behandeln

FILE_FLAG_OPEN_NO_RECALL von CreateFile ist ein Flag, das die Absicht ausdrückt, angeforderte Daten remote zu lassen und nicht auf lokalen Speicher zurückzuholen. Es ist kein Flag, das die Datenübertragung zum Lesen des Inhalts verbietet.¹⁴

Bei Untersuchungen, die Bandbreite und Wartezeit vermeiden sollen, begnügen Sie sich mit Metadaten wie Attributen, Größe und Zeitstempeln. Wählen Sie Wege, die keinen Lesezugriff anfordern: die Informationen der Auflistung nutzen oder bei Bedarf mit Zugriffsrechten 0 öffnen, um Attribute zu holen.¹⁴

6.3. Datenablage und Hinweise bei Fehlern in die Spezifikation aufnehmen

In einer KFM-Umgebung kann auch „Dokumente“ unter OneDrive liegen. Legen Sie Einstellungen, Datenbank und Arbeitsdateien der App an einen zum Zweck passenden Ort wie %ProgramData% oder %LocalAppData%, und wählen Sie Desktop oder Dokumente nicht leichthin als Standard für Speichern und Import. Die konkreten Entscheidungen stehen in „Wie Windows-Apps lokale Daten speichern sollten“.

Können Benutzer den Speicherort wählen, legen Sie fest, wie sich die App verhält, wenn sie einen Ort unter OneDrive wählen. Nehmen Sie in die Spezifikation auf, etwa anhand der Synchronisierungswurzel aus OneDrive / OneDriveCommercial zu warnen und die Ablage von Sperrdateien oder einer Datenbank dort abzulehnen.

Scheitert das Lesen, zeigen und zeichnen Sie neben Zielpfad und Fehlercode auch auf, dass der Pfad unter OneDrive liegt, sofern das erkennbar ist. Schon der Hinweis „prüfen Sie den Zustand von OneDrive“, wenn 0x8007016A oder Ähnliches erkannt wird, erleichtert es Vor-Ort und Helpdesk, mit derselben Prüfliste zu untersuchen.

7. Maßnahmen der IT-Seite — den Zustand mit Anheften und Richtlinie halten

7.1. Nur die nötigen Ordner anheften

Bevor Sie Dateien bei Bedarf überall abschalten, setzen Sie die Ordner, die Geschäftsanwendungen lesen, auf „Immer auf diesem Gerät behalten“. Nutzen Sie beim Provisionieren attrib +p -u <Ordner> /s /d, übergeben Sie das Gerät erst an den Betrieb, wenn der Download abgeschlossen ist.⁶⁴

„Einmal geöffnet“ verhindert spätere automatische Freigabe nicht. Der Punkt ist, die nötigen Orte auf Ordnerebene anzuheften und diesen Zustand in die Supportverfahren aufzunehmen.

7.2. KFM und Dateien bei Bedarf bewusst konfigurieren

Damit es nicht „plötzlich aktiv war“, steuern Sie die Einstellungen mit Gruppenrichtlinie oder Intune. Weil es auch Richtlinien gibt, die das Zurücknehmen verbieten, prüfen Sie nicht nur den Bildschirm des Geräts, sondern auch die in der Organisation geltenden Einstellungen.⁸¹

DehydrateSyncedTeamSites ist eine Richtlinie, die den lokalen Inhalt synchronisierter Teamwebsites verringert. Kehren nötige Dateien zum Wolkensymbol zurück, prüfen Sie neben der Benutzeraktion „Speicherplatz freigeben“ auch solche Organisationseinstellungen.⁸

7.3. Speicheroptimierung und die Kosten der Vollsynchronisierung prüfen

Speicheroptimierung (Storage Sense) kann Cloud-Dateien, die eine festgelegte Zahl Tage nicht geöffnet wurden, wieder nur online machen. Die Tage konfiguriert ConfigStorageSenseCloudContentDehydrationThreshold; der Standard 0 der Richtlinie bedeutet kein automatisches Zurücksetzen. Benutzer können es jedoch in den Einstellungen aktiviert haben, oder die Organisation hat es für Geräte mit knappem Speicher gesetzt.¹⁰

Betroffen sind „lokal verfügbare“ Dateien, die nicht ausdrücklich angeheftet sind. Angeheftete Dateien sind von der automatischen Freigabe ausgenommen; wenn „bis letzte Woche ließ es sich öffnen, jetzt ist das Wolkensymbol zurück“, prüfen Sie, ob das P-Attribut wirklich gesetzt war.⁴

FilesOnDemandEnabled zu deaktivieren kehrt zur herkömmlichen Voll-Download-Synchronisierung zurück, erhöht aber Datenträgerverbrauch und Bandbreite der ersten Synchronisierung. Microsoft empfiehlt, es aktiv zu lassen. Behandeln Sie das Abschalten als begrenzte Maßnahme, nachdem Datenmenge und Datenträgerkapazität der betroffenen Benutzer geprüft wurden.⁸⁴

Bauen Sie die Reihenfolge aus Kapitel 2 — Pfad, Attribute, OneDrive läuft, Netzwerk, freier Platz, Aufzeichnung — in die Helpdesk-Vorlage ein. Dann wird die Ursache auch bei Personalwechsel in derselben Reihenfolge untersucht, statt Einstellungen wahllos umzuschalten.

8. Zusammenfassung

Dateistörungen in einer OneDrive-Umgebung lassen sich ordnen, sobald Sie „hat sich der Ort geändert?“ und „muss der Inhalt nachgeladen werden?“ trennen. KFM begegnen Sie mit Pfadauflösung über die APIs für bekannte Ordner, Dateien bei Bedarf mit einem Entwurf, der Attribute prüft und dann nur den nötigen Inhalt liest.

Darüber hinaus prüfen Sie, wie Zurückschreiben an ein überwachtes Ziel, lange Exklusivsperren und vollständige Scans mit der Synchronisierung zusammenfallen. Interne App-Daten bleiben außerhalb von OneDrive, den Inhalt der für das Geschäft nötigen Dateien halten Anheften und Richtlinie. Diese Arbeitsteilung ist die Grundlage, nicht beim Notbehelf stehen zu bleiben.

Wenn als Nächstes jemand meldet, „die Datei ist da, lässt sich aber nicht lesen“, fragen Sie zuerst:

Sieht die App den jetzigen, richtigen Ort? Und liegt der Inhalt dieser Datei wirklich lokal vor?

Verwandte Artikel

• Die Tiefen von Windows I/O (Teil 5) — NTFS-Interna: Das Dateisystem anhand des MFT verstehen
• Praxisleitfaden für FileSystemWatcher - Umgang mit verpassten und doppelten Ereignissen
• Die Fallstricke von Netzlaufwerken und UNC-Pfaden ── Fileserver (Freigabeordner) in Business-Anwendungen richtig einsetzen
• Grundlagen des wechselseitigen Ausschlusses bei der Dateiintegration - Best Practices für Dateisperren und atomare Claims
• Wie Windows-Apps lokale Daten speichern sollten — Entscheidungstabelle für SQLite / JSON / Registrierung / Access
• MAX_PATH und die Fallstricke von Windows-Pfaden und Dateinamen ── Das 260-Zeichen-Limit, reservierte Namen, abschließende Punkte und Groß-/Kleinschreibung

Verwandte Beratungsbereiche

KomuraSoft LLC übernimmt die Untersuchung von Ausfällen geschäftlicher Apps, die OneDrive und Cloud-Speicher betreffen — „ein Import, der funktionierte, funktioniert nach einem PC-Tausch nicht mehr“, „eine Datei öffnet sich nur auf einem bestimmten PC nicht“ —, Entwurf und Behebung von Dateiverarbeitung und Überwachung, die Platzhalter voraussetzen, und Reviews der Speicherortgestaltung in einer KFM- / Dateien-bei-Bedarf-Umgebung. Beim Isolieren des Symptoms zu beginnen ist in Ordnung.

• Windows-App-Entwicklung
• Fehleruntersuchung und Ursachenanalyse
• Technische Beratung und Design-Review
• Kontakt

Quellen

Verwandte Artikel

Aktuelle Artikel mit denselben Schlagwörtern führen zu verwandten Themen weiter.

Verwandte Themen

Diese Seiten ordnen den Artikel in einen größeren Leistungs- und Entscheidungskontext ein.

Leistungen zu diesem Thema

Dieser Artikel ist direkt mit den folgenden Leistungen verbunden.

Häufige Fragen

Fragen, die in Beratungen zu diesem Artikelthema häufig gestellt werden.

Eine Geschäftsanwendung sagt „Datei nicht gefunden“ und kann eine CSV auf dem Desktop nicht lesen. Warum?

In vielen Fällen wurde der Desktop-Ordner selbst durch OneDrives Known Folder Move (KFM) nach C:\Users\<Benutzername>\OneDrive\Desktop verschoben, oder die Datei ist ein nur-online-Platzhalter. Eine App, die einen festen Pfad wie C:\Users\<Benutzername>\Desktop voraussetzt, findet die Datei nach dem Umzug nicht. Selbst wenn der Pfad stimmt, kann eine nur-online-Datei fehlschlagen, wenn OneDrive gestoppt oder das Netz gestört ist. Prüfen Sie zuerst, ob der Zielpfad unter OneDrive liegt, und mit attrib, ob U (nur online) gesetzt ist. Als Notbehelf sichern Sie den Inhalt lokal mit „Immer auf diesem Gerät behalten“ im Kontextmenü.

Kann ein Programm erkennen, ob eine Datei nur online ist?

Ja. Ein nur-online-Platzhalter trägt Attribute wie FILE_ATTRIBUTE_OFFLINE und FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS (0x00400000), sodass Sie den Zustand aus den Dateiattributen beurteilen können, ohne den Inhalt herunterzuladen. Attribute lesen oder einen Ordner auflisten verursacht keine Hydration (keinen Download). In .NET sind manche Werte auf FileAttributes nicht definiert; Sie wandeln in eine Ganzzahl und prüfen bitweise. Wenn Sie wirklich öffnen müssen, ohne den Inhalt zu lesen, steht etwa FILE_FLAG_OPEN_NO_RECALL von CreateFile zur Verfügung.

Löst das Abschalten von Dateien bei Bedarf das Problem?

Behandeln Sie das Abschalten als letzten Ausweg. Das Deaktivieren lädt jede Datei im Synchronisierungsbereich lokal herunter, sodass Plattenkapazität und Netzlast der ersten Synchronisierung groß werden; Microsoft empfiehlt, es eingeschaltet zu lassen. Praktisch ist es flexibler, nur die Ordner, die eine Geschäftsanwendung liest, auf „Immer auf diesem Gerät behalten“ zu setzen (anzuheften). Grundsätzlicher und zuverlässiger ist, Daten- und Importordner der App nicht unter OneDrive-Verwaltung zu legen.

Ich habe „Immer auf diesem Gerät behalten“ gesetzt, aber manche Dateien werden wieder zum Wolkensymbol. Warum?

Prüfen Sie zuerst mit attrib, ob die Datei wirklich den Pin hat (P-Attribut). Eine angeheftete Datei liegt außerhalb der automatischen Umwandlung ins Nur-Online durch Speicheroptimierung, aber eine Datei, die nur „lokal verfügbar“ ist, weil jemand sie geöffnet hat, ohne sie anzuheften, kann je nach Speicheroptimierung und Richtlinie nach einer Frist wieder nur online werden. Die eigene Aktion „Speicherplatz freigeben“ und eine Richtlinie, die Teamwebsite-Dateien nur online macht (DehydrateSyncedTeamSites), bringen das Wolkensymbol ebenfalls zurück. Ordner, die für das Geschäft lokal bleiben müssen, betreiben Sie durch Anheften auf Ordnerebene.

Autorenprofil

Profilseite des Artikelautors.

Go Komura

Geschäftsführer von KomuraSoft LLC

Spezialisiert auf Windows-Softwareentwicklung, technische Beratung und Fehleranalyse, insbesondere bei bestehenden Systemen und schwer reproduzierbaren Störungen.