ユーザー名によるファイルの検索 (ディスク クォータが有効な場合)、ファイルに割り当てられた範囲の照会、ファイルの短い名前の設定、ファイルの有効なデータ長の設定、ファイルのゼロ データの設定、または新しいファイルの作成を行います。
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>
Parameters
| Parameter | Description |
|---|---|
| createnew | 指定された名前とサイズのファイルを、0 で構成されるコンテンツで作成します。 |
<length> |
ファイルの有効なデータ長を指定します。 |
| findbysid | ディスク クォータが有効になっている NTFS ボリューム上の、指定されたユーザーに属するファイルを検索します。 |
<username> |
ユーザーのユーザー名またはログオン名を指定します。 |
<directory> |
ディレクトリへの完全パスを指定します。たとえば、C:\users など。 |
| optimizemetadata | これにより、指定されたファイルのメタデータが即座に圧縮されます。 |
| /a | 最適化の前後にファイルのメタデータを分析します。 |
| queryallocranges | NTFS ボリューム上のファイルに割り当てられた範囲を照会します。 ファイルにスパース領域があるかどうかを判断する場合に便利です。 |
offset=<offset> |
0 に設定する範囲の先頭を指定します。 |
length=<length> |
範囲の長さ (バイト単位) を指定します。 |
| queryextents | ファイルのエクステントを照会します。 |
| /r |
<filename> が再解析ポイントである場合は、そのターゲットではなく開きます。 |
<startingvcn> |
照会する最初の VCN を指定します。 省略した場合は、VCN 0 から開始します。 |
<numvcns> |
照会する VCN の数。 省略した場合または 0 の場合は、EOF まで照会します。 |
| queryfileid | NTFS ボリューム上のファイルのファイル ID を照会します。 |
<volume> |
ボリュームをドライブ名の後にコロンを続けて指定します。 |
| queryfilenamebyid | NTFS ボリューム上の指定したファイル ID のランダムなリンク名を表示します。 ファイルは、そのファイルをポイントする複数のリンク名を持つことができるため、ファイル名の照会結果としてどのファイル リンクが提供されるかは保証されません。 |
<fileid> |
NTFS ボリューム上のファイルの ID を指定します。 |
| queryoptimizemetadata | ファイルのメタデータ状態を照会します。 |
| queryvaliddata | ファイルの有効なデータ長を照会します。 |
| /d | 有効なデータの詳細情報を表示します。 |
| seteof | 指定されたファイルの EOF を設定します。 |
| setshortname | NTFS ボリューム上のファイルの短い名前 (8.3 文字長のファイル名) を設定します。 |
<shortname> |
ファイルの短い名前を指定します。 |
| setvaliddata | NTFS ボリューム上のファイルの有効なデータ長を設定します。 |
<datalength> |
ファイルの長さをバイト単位で指定します。 |
| setzerodata | Sets a range (specified by offset and length) of the file to zeroes, which empties the file. ファイルがスパース ファイルの場合は、基になるアロケーション ユニットがデコミットされます。 |
Remarks
NTFS には、ファイルの長さに関する重要な概念が 2 つあります。ファイルの終端 (EOF) マーカーと有効なデータ長 (VDL) です。 EOF は、ファイルの実際の長さを示します。 VDL は、ディスク上の有効なデータの長さを識別します。 VDL と EOF の間の読み取りでは、C2 オブジェクト再利用要件を維持するために、自動的に 0 が返されます。
The setvaliddata parameter is only available for administrators because it requires the Perform volume maintenance tasks (SeManageVolumePrivilege) privilege. この機能は、高度なマルチメディアおよびシステム エリア ネットワークのシナリオでのみ必要です。 The setvaliddata parameter must be a positive value that is greater than the current VDL, but less than the current file size.
次の場合にプログラムで VDL を設定すると便利です。
ハードウェア チャネルを使用して、未処理のクラスターを直接ディスクに書き込む場合。 これにより、プログラムは、この範囲にユーザーに返される有効なデータが含まれていることをファイルシステムに通知することができます。
パフォーマンスが問題になるときに、大きなファイルを作成する場合。 これにより、ファイルが作成または拡張されたときに、ファイルがゼロでいっぱいになるまでにかかる時間を回避できます。
Examples
To find files that are owned by scottb on drive C, type:
fsutil file findbysid scottb c:\users
NTFS ボリューム上のファイルに割り当てられた範囲を照会するには、次のように入力します。
fsutil file queryallocranges offset=1024 length=64 c:\temp\sample.txt
ファイルのメタデータを最適化するには、次のように入力します。
fsutil file optimizemetadata C:\largefragmentedfile.txt
ファイルのエクステントを照会するには、次のように入力します。
fsutil file queryextents C:\Temp\sample.txt
ファイルの EOF を設定するには、次のように入力します。
fsutil file seteof C:\testfile.txt 1000
To set the short name for the file, longfilename.txt on drive C to longfile.txt, type:
fsutil file setshortname c:\longfilename.txt longfile.txt
To set the valid data length to 4096 bytes for a file named testfile.txt on an NTFS volume, type:
fsutil file setvaliddata c:\testfile.txt 4096
NTFS ボリューム上のファイルの範囲をゼロに設定して空にするには、次のように入力します。
fsutil file setzerodata offset=100 length=150 c:\temp\sample.txt