fsutil usn
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
Gère le journal des modifications de numéro de séquences de mise à jour (USN). Le journal des modifications USN fournit un enregistrement cohérent de toutes les modifications apportées aux fichiers du volume. Lors de l’ajout, de la suppression et de la modification de fichiers, de répertoires et d’autres objets NTFS, NTFS entre des enregistrements dans le journal des modifications USN, un pour chaque volume sur l’ordinateur. Chaque enregistrement indique le type de modification et l'objet modifié. Les nouveaux enregistrements sont ajoutés à la fin du flux.
Syntaxe
fsutil usn [createjournal] m=<maxsize> a=<allocationdelta> <volumepath>
fsutil usn [deletejournal] {/d | /n} <volumepath>
fsutil usn [enablerangetracking] <volumepath> [options]
fsutil usn [enumdata] <fileref> <lowUSN> <highUSN> <volumepath>
fsutil usn [queryjournal] <volumepath>
fsutil usn [readdata] <filename>
fsutil usn [readjournal] [c= <chunk-size> s=<file-size-threshold>] <volumepath>
Paramètres
| Paramètre | Description |
|---|---|
| createjournal | Crée un journal des modifications USN. |
m=<maxsize> |
Spécifie la taille maximale, en octets, que NTFS alloue pour le journal des modifications. |
a=<allocationdelta> |
Spécifie la taille, en octets, de l’allocation de mémoire ajoutée à la fin et supprimée du début du journal des modifications. |
<volumepath> |
Spécifie la lettre de lecteur (suivie d’un signe deux-points). |
| deletejournal | Supprime ou désactive un journal des modifications USN actif. ATTENTION : La suppression du journal des modifications a un impact sur le service de réplication de fichiers (FRS) et le service d’indexation, car il nécessite que ces services effectuent une analyse complète (et chronophage) du volume. Cela a à son tour un impact négatif sur la réplication SYSVOL du FRS et la réplication entre les alternatives de liaison DFS pendant que le volume est réanalysé. |
| /d | Désactive un journal des modifications USN actif et retourne le contrôle d’entrée/sortie (E/S) pendant la désactivation du journal des modifications. |
| /n | Désactive un journal des modifications USN actif et retourne le contrôle d’E/S uniquement après la désactivation du journal des modifications. |
| enablerangetracking | Active le suivi de la plage d’écriture USN pour un volume. |
c=<chunk-size> |
Spécifie la taille de segment à suivre sur un volume. |
s=<file-size-threshold> |
Spécifie le seuil de taille de fichier pour le suivi de la plage. |
| enumdata | Énumère et répertorie les entrées du journal des modifications entre deux limites spécifiées. |
<fileref> |
Spécifie la position ordinale dans les fichiers sur le volume à laquelle l’énumération doit commencer. |
<lowUSN> |
Spécifie la limite inférieure de la plage de valeurs USN utilisées pour filtrer les enregistrements retournés. Seuls les enregistrements dont l’USN du dernier journal des modifications dans la plage ou égal aux valeurs de membre lowUSN et highUSN sont retournés. |
<highUSN> |
Spécifie la limite supérieure de la plage de valeurs USN utilisées pour filtrer les fichiers retournés. |
| queryjournal | Interroge les données USN d’un volume pour recueillir des informations sur le journal des modifications actuel, ses enregistrements et sa capacité. |
| readdata | Lit les données USN d’un fichier. |
<filename> |
Spécifie le chemin d’accès complet au fichier, y compris le nom et l’extension du fichier. Par exemple : C:\documents\filename.txt. |
| readjournal | Lit les enregistrements USN dans le journal USN. |
minver=<number> |
Version majeure minimale de USN_RECORD à retourner. Default = 2. |
maxver=<number> |
Version majeure maximale de USN_RECORD à retourner. Default = 4. |
startusn=<USN number> |
USN à partir duquel commencer à lire le journal USN. Valeur par défaut = 0. |
Notes
Les programmes peuvent consulter le journal des modifications USN pour déterminer toutes les modifications apportées à un ensemble de fichiers. Le journal des modifications USN est beaucoup plus efficace que la vérification des timestamps ou l’inscription aux notifications de fichiers. Le journal des modifications USN est activé et utilisé par le service d’indexation, le service de réplication de fichiers (FRS), les services d’installation à distance (RIS) et le stockage à distance.
Si un journal des modifications existe déjà sur un volume, le paramètre createjournal met à jour les paramètres maxsize et allocationdelta du journal des modifications. Cela vous permet d’augmenter le nombre d’enregistrements qu’un journal actif conserve sans avoir à le désactiver.
Le journal des modifications peut dépasser cette valeur cible, mais le journal des modifications est tronqué au point de contrôle NTFS suivant pour être inférieur à cette valeur. NTFS examine le journal des modifications et le supprime lorsque sa taille dépasse la valeur de maxsize plus la valeur d’allocationdelta. Aux points de contrôle NTFS, le système d’exploitation écrit des enregistrements dans le fichier journal NTFS qui permettent à NTFS de déterminer le traitement requis pour récupérer après une défaillance.
Le journal des modifications peut atteindre plus que la somme des valeurs de maxsize et allocationdelta avant d’être rogné.
La suppression ou la désactivation d’un journal des modifications actif prend beaucoup de temps, car le système doit accéder à tous les enregistrements de la table de fichiers maîtres (MFT) et définir le dernier attribut USN sur 0 (zéro). Ce processus peut prendre plusieurs minutes et peut se poursuivre après le redémarrage du système, si un redémarrage est nécessaire. Pendant ce processus, le journal des modifications n’est pas considéré comme actif, et n’est pas désactivé non plus. Lorsque le système désactive le journal, il est impossible d’y accéder, et toutes les opérations de journal retournent des erreurs. Vous devez faire très attention lors de la désactivation d’un journal actif, car cela affecte négativement les autres applications qui utilisent le journal.
Exemples
Pour créer un journal des modifications USN sur le lecteur C, tapez :
fsutil usn createjournal m=1000 a=100 c:
Pour supprimer un journal des modifications USN actif sur le lecteur C, tapez :
fsutil usn deletejournal /d c:
Pour activer le suivi de plage avec une taille de bloc et un seuil de taille de fichier spécifiés, tapez :
fsutil usn enablerangetracking c=16384 s=67108864 C:
Pour énumérer et répertorier les entrées du journal des modifications entre deux limites spécifiées sur le lecteur C, tapez :
fsutil usn enumdata 1 0 1 c:
Pour interroger des données USN pour un volume sur le lecteur C, tapez :
fsutil usn queryjournal c:
Pour lire les données USN d’un fichier dans le dossier \Temp sur le lecteur C, tapez :
fsutil usn readdata c:\temp\sample.txt
Pour lire le journal USN avec un USN de début spécifique, tapez :
fsutil usn readjournal startusn=0xF00