fsutil file

Gilt für: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8

Sucht eine Datei anhand des Benutzernamens (wenn Datenträgerkontingente aktiviert sind), fragt die zugeordneten Bereiche für eine Datei ab, legt den kurzen Namen einer Datei, die gültige Datenlänge einer Datei, Null als Daten für eine Datei fest oder erstellt eine neue Datei.

Syntax

fsutil file [createnew] <filename> <length>
fsutil file [findbysid] <username> <directory>
fsutil file [optimizemetadata] [/A] <filename>
fsutil file [queryallocranges] offset=<offset> length=<length> <filename>
fsutil file [queryextents] [/R] <filename> [<startingvcn> [<numvcns>]]
fsutil file [queryfileid] <filename>
fsutil file [queryfilenamebyid] <volume> <fileid>
fsutil file [queryoptimizemetadata] <filename>
fsutil file [queryvaliddata] [/R] [/D] <filename>
fsutil file [seteof] <filename> <length>
fsutil file [setshortname] <filename> <shortname>
fsutil file [setvaliddata] <filename> <datalength>
fsutil file [setzerodata] offset=<offset> length=<length> <filename>

Parameter

Parameter BESCHREIBUNG
createnew Erstellt eine Datei mit dem angegebenen Namen und der angegebenen Größe mit Inhalten, die aus Nullen bestehen.
<length> Gibt die gültige Datenlänge der Datei an.
findbysid Sucht Dateien, die zu einem angegebenen Benutzer gehören, auf NTFS-Volumes, auf denen Datenträgerkontingente aktiviert sind.
<username> Gibt den Benutzernamen oder Anmeldenamen des Benutzers an.
<directory> Gibt den vollständigen Pfad zum Verzeichnis an, z. B. C:\users.
optimizemetadata Führt eine sofortige Komprimierung der Metadaten für eine bestimmte Datei durch.
/a Analysieren von Dateimetadaten vor und nach der Optimierung.
queryallocranges Fragt die zugeordneten Bereiche für eine Datei auf einem NTFS-Volume ab. Nützlich, um zu ermitteln, ob eine Datei Bereiche mit geringer Dichte aufweist.
offset=<offset> Gibt den Anfang des Bereichs an, der auf Nullen festgelegt werden soll.
length=<length> Gibt die Länge des Bereichs (in Bytes) an.
queryextents Fragt die Ausdehnung einer Datei ab.
/r Wenn es sich bei <filename> um einen Analysepunkt handelt, wird er anstelle des Ziels geöffnet.
<startingvcn> Gibt den ersten abzufragenden VCN an. Ohne Angabe wird bei VCN 0 begonnen.
<numvcns> Anzahl der abzufragenden VCNs. Ohne Angabe oder beim Wert 0 wird bis zum EOF abgefragt.
queryfileid Fragt die Datei-ID einer Datei auf einem NTFS-Volume ab.
<volume> Gibt das Volume als Laufwerksnamen gefolgt von einem Doppelpunkt an.
queryfilenamebyid Zeigt einen zufälligen Linknamen für eine angegebene Datei-ID auf einem NTFS-Volume an. Da eine Datei mehrere Linknamen aufweisen kann, die auf diese Datei verweisen, ist nicht garantiert, welcher Dateilink als Ergebnis der Abfrage für den Dateinamen zur Verfügung gestellt wird.
<fileid> Gibt die ID der Datei auf einem NTFS-Volume an.
queryoptimizemetadata Fragt den Metadatenstatus einer Datei ab.
queryvaliddata Fragt die gültige Datenlänge für eine Datei ab.
/d Zeigt detaillierte gültige Dateninformationen an.
seteof Legt das EOF der angegebenen Datei fest.
setshortname Legt den kurzen Namen (Dateiname mit einer Länge von 8.3 Zeichen) für eine Datei auf einem NTFS-Volume fest.
<shortname> Gibt den kurzen Namen der Datei an.
setvaliddata Legt die gültige Datenlänge für eine Datei auf einem NTFS-Volume fest.
<datalength> Ruft die Länge der Datei in Byte ab.
setzerodata Legt einen Bereich der Datei auf Nullen fest (der durch Offset und Länge angegeben ist), wodurch die Datei geleert wird. Wenn es sich bei der Datei um eine Sparsedatei handelt, wird der Commit der zugrunde liegenden Zuordnungseinheiten aufgehoben.

Hinweise

  • In NTFS gibt es zwei wichtige Konzepte der Dateilänge: den EOF-Marker (End-of-File) und die gültige Datenlänge (Valid Data Length, VDL). Das EOF gibt die tatsächliche Länge der Datei an. Die VDL gibt die Länge der gültigen Daten auf dem Datenträger an. Alle Lesevorgänge zwischen VDL und EOF geben automatisch 0 zurück, um die Anforderung zur Wiederverwendung von C2-Objekten beizubehalten.

  • Der Parameter setvaliddata ist nur für Administratoren verfügbar, da er die Berechtigung „Durchführen von Volumewartungsaufgaben“ (SeManageVolumePrivilege) erfordert. Dieses Feature ist nur für erweiterte Multimedia- und Systembereichs-Netzwerkszenarien erforderlich. Der Parameter setvaliddata muss ein positiver Wert sein, der größer als die aktuelle VDL, aber kleiner als die aktuelle Dateigröße ist.

    Das Festlegen einer VDL ist für Programme unter diesen Umständen nützlich:

    • Schreiben von Rohclustern über einen Hardwarekanal direkt auf den Datenträger. Dadurch kann das Programm das Dateisystem darüber informieren, dass dieser Bereich gültige Daten enthält, die an den Benutzer zurückgegeben werden können.

    • Erstellen großer Dateien, wenn die Leistung ein Problem ist. Dadurch wird der Zeitaufwand vermieden, um die Datei mit Nullen zu füllen, wenn die Datei erstellt oder erweitert wird.

Beispiele

Geben Sie Folgendes ein, um Dateien auf Laufwerk C zu finden, die im Besitz von scottb sind:

fsutil file findbysid scottb c:\users

Geben Sie Folgendes ein, um die zugeordneten Bereiche für eine Datei auf einem NTFS-Volume abzufragen:

fsutil file queryallocranges offset=1024 length=64 c:\temp\sample.txt

Geben Sie Folgendes ein, um Metadaten für eine Datei zu optimieren:

fsutil file optimizemetadata C:\largefragmentedfile.txt

Geben Sie Folgendes ein, um die Ausdehnung einer Datei abzufragen:

fsutil file queryextents C:\Temp\sample.txt

Geben Sie Folgendes ein, um das EOF für eine Datei festzulegen:

fsutil file seteof C:\testfile.txt 1000

Zum Festlegen des kurzen Namens für die Datei longfilename.txt auf Laufwerk C auf longfile.txt, geben Sie Folgendes ein:

fsutil file setshortname c:\longfilename.txt longfile.txt

Geben Sie Folgendes ein, um die gültige Datenlänge für eine Datei mit dem Namen testfile.txt auf einem NTFS-Volume auf 4096 Bytes festzulegen:

fsutil file setvaliddata c:\testfile.txt 4096

Geben Sie Folgendes ein, um einen Bereich einer Datei auf einem NTFS-Volume auf Nullen festzulegen, um ihn zu leeren:

fsutil file setzerodata offset=100 length=150 c:\temp\sample.txt