fsutil file
S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8
Recherche un fichier par nom d’utilisateur (si les quotas de disque sont activés), les requêtes allouées pour un fichier, définit le nom court d’un fichier, définit la longueur de données valide d’un fichier, définit zéro donnée pour un fichier ou crée un fichier.
Syntaxe
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>
Paramètres
| Paramètre | Description |
|---|---|
| createnew | Crée un fichier du nom et de la taille spécifiés, avec un contenu composé de zéros. |
<length> |
Spécifie la longueur des données valides du fichier. |
| findbysid | Recherche les fichiers qui appartiennent à un utilisateur spécifié sur les volumes NTFS où les quotas de disque sont activés. |
<username> |
Spécifie le nom d’utilisateur ou le nom d’ouverture de session de l’utilisateur. |
<directory> |
Spécifie le chemin d’accès complet au répertoire, par exemple C:\users. |
| optimizemetadata | Cela permet de compacter immédiatement les métadonnées d’un fichier donné. |
| /a | Analysez les métadonnées de fichier avant et après l’optimisation. |
| queryallocranges | Interroge les plages allouées pour un fichier sur un volume NTFS. Utile pour déterminer si un fichier a des régions éparses. |
offset=<offset> |
Spécifie le début de la plage qui doit être définie sur zéros. |
length=<length> |
Spécifie la longueur de la plage (en octets). |
| queryextents | Interroge les étendues d’un fichier. |
| /r | Si <filename> est un point d’analyse, ouvrez-le plutôt que sa cible. |
<startingvcn> |
Spécifie le premier VCN à interroger. En cas d’omission, commencez par VCN 0. |
<numvcns> |
Nombre de VCN à interroger. Si omise ou 0, interrogez jusqu’à EOF. |
| queryfileid | Interroge l’ID de fichier d’un fichier sur un volume NTFS. |
<volume> |
Spécifie le volume comme nom de lecteur suivi d’un signe deux-points. |
| queryfilenamebyid | Affiche un nom de lien aléatoire pour un ID de fichier spécifié sur un volume NTFS. Étant donné qu’un fichier peut avoir plusieurs noms de lien pointant vers ce fichier, il n’est pas garanti quel lien de fichier sera fourni à la suite de la requête pour le nom du fichier. |
<fileid> |
Spécifie l’ID du fichier sur un volume NTFS. |
| queryoptimizemetadata | Interroge l’état des métadonnées d’un fichier. |
| queryvaliddata | Interroge la longueur des données valide pour un fichier. |
| /d | Affichez des informations détaillées sur les données valides. |
| seteof | Définit l’EOF du fichier donné. |
| setshortname | Définit le nom court (nom de fichier de longueur de caractères 8,3) pour un fichier sur un volume NTFS. |
<shortname> |
Spécifie le nom court du fichier. |
| setvaliddata | Définit la longueur des données valide pour un fichier sur un volume NTFS. |
<datalength> |
Spécifie la longueur du fichier en octets. |
| setzerodata | Définit une plage (spécifiée par décalage et longueur) du fichier sur zéros, ce qui vide le fichier. Si le fichier est un fichier partiellement alloué, les unités d’allocation sous-jacentes sont décompressé. |
Notes
Dans NTFS, il existe deux concepts importants de longueur de fichier : le marqueur de fin de fichier (EOF) et la longueur des données valides (VDL). L’EOF indique la longueur réelle du fichier. Le VDL identifie la longueur des données valides sur le disque. Toutes les lectures entre VDL et EOF retournent automatiquement 0 pour préserver l’exigence de réutilisation de l’objet C2.
Le paramètre setvaliddata est disponible uniquement pour les administrateurs, car il nécessite le privilège Effectuer des tâches de maintenance en volume (SeManageVolumePrivilege). Cette fonctionnalité n’est requise que pour les scénarios de réseau multimédia et système avancés. Le paramètre setvaliddata doit être une valeur positive supérieure à la valeur VDL actuelle, mais inférieure à la taille de fichier actuelle.
Il est utile pour les programmes de définir un VDL lorsque :
Écriture de clusters bruts directement sur le disque via un canal matériel. Cela permet au programme d’informer le système de fichiers que cette plage contient des données valides qui peuvent être retournées à l’utilisateur.
Création de fichiers volumineux lorsque les performances sont un problème. Cela évite le temps nécessaire pour remplir le fichier avec des zéros lors de la création ou de l’extension du fichier.
Exemples
Pour rechercher les fichiers appartenant à scottb sur le lecteur C, tapez :
fsutil file findbysid scottb c:\users
Pour interroger les plages allouées pour un fichier sur un volume NTFS, tapez :
fsutil file queryallocranges offset=1024 length=64 c:\temp\sample.txt
Pour optimiser les métadonnées d’un fichier, tapez :
fsutil file optimizemetadata C:\largefragmentedfile.txt
Pour interroger les étendues d’un fichier, tapez :
fsutil file queryextents C:\Temp\sample.txt
Pour définir l’EOF pour un fichier, tapez :
fsutil file seteof C:\testfile.txt 1000
Pour définir le nom court du fichier, longfilename.txt sur le lecteur C pour longfile.txt, tapez :
fsutil file setshortname c:\longfilename.txt longfile.txt
Pour définir la longueur des données valide sur 4 096 octets pour un fichier nommé testfile.txt sur un volume NTFS, tapez :
fsutil file setvaliddata c:\testfile.txt 4096
Pour définir une plage d’un fichier sur un volume NTFS sur zéros afin de le vider, tapez :
fsutil file setzerodata offset=100 length=150 c:\temp\sample.txt