Partilhar via


fsutil usn

Gerencia o diário de alterações do número de sequência de atualização (USN). O diário de alterações USN fornece um log persistente de todas as alterações feitas nos arquivos no volume. À medida que arquivos, diretórios e outros objetos NTFS são adicionados, excluídos e modificados, o NTFS insere registros no diário de alterações USN, um para cada volume no computador. Cada registro indica o tipo de alteração e o objeto alterado. Novos registros são anexados ao final do fluxo.

Syntax

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>

Parameters

Parameter Description
createjournal Cria um diário de alterações USN.
m=<maxsize> Especifica o tamanho máximo, em bytes, que o NTFS aloca para o diário de alterações.
a=<allocationdelta> Especifica o tamanho, em bytes, da alocação de memória que é adicionada ao final e removida do início do diário de alterações.
<volumepath> Especifica a letra da unidade (seguida de dois pontos).
deletejournal Exclui ou desabilita um diário de alterações USN ativo.

ATENÇÃO: A exclusão do diário de alterações afeta o FRS (Serviço de Replicação de Arquivos) e o Serviço de Indexação, pois exige que esses serviços executem uma verificação completa (e demorada) do volume. Isso, por sua vez, afeta negativamente a replicação FRS SYSVOL e a replicação entre o link DFS alterna enquanto o volume está sendo verificado novamente.

/d Desabilita um diário de alterações USN ativo e retorna o controle de entrada/saída (E/S) enquanto o diário de alterações está sendo desabilitado.
/n Desativa um diário de alterações USN ativo e retorna o controle de E/S somente depois que o diário de alterações é desativado.
enablerangetracking Permite o rastreamento do intervalo de gravação USN para um volume.
c=<chunk-size> Especifica o tamanho do bloco a ser controlado em um volume.
s=<file-size-threshold> Especifica o limite de tamanho de arquivo para rastreamento de intervalo.
enumdata Enumera e lista as entradas do diário de alterações entre dois limites especificados.
<fileref> Especifica a posição ordinal dentro dos arquivos no volume no qual a enumeração deve começar.
<lowUSN> Especifica o limite inferior do intervalo de valores USN usados para filtrar os registros retornados. Somente os registros cujo USN do último diário de alterações esteja entre ou seja igual aos valores de membro lowUSN e highUSN são retornados.
<highUSN> Especifica o limite superior do intervalo de valores USN usados para filtrar os arquivos retornados.
queryjournal Consulta os dados USN de um volume para coletar informações sobre o diário de alterações atual, seus registros e sua capacidade.
readdata Lê os dados USN de um arquivo.
<filename> Especifica o caminho completo para o arquivo, incluindo o nome do arquivo e a extensão Por exemplo: C:\documents\filename.txt.
readjournal Lê os registros da USN no diário da USN.
minver=<number> A versão principal mínima do USN_RECORD a ser retornada. Padrão = 2.
maxver=<number> A versão principal máxima do USN_RECORD a retornar. Padrão = 4.
startusn=<USN number> USN para começar a ler o diário da USN. Padrão = 0.

Remarks

  • Os programas podem consultar o diário de alterações USN para determinar todas as modificações feitas em um conjunto de arquivos. O diário de alterações USN é muito mais eficiente do que verificar carimbos de data/hora ou registrar-se para notificações de arquivos. O diário de alterações USN é habilitado e usado pelo Serviço de Indexação, FRS (Serviço de Replicação de Arquivos), Serviços de Instalação Remota (RIS) e Armazenamento Remoto.

  • Se já existir um diário de alterações em um volume, o parâmetro createjournal atualizará os parâmetros maxsize e allocationdelta do diário de alterações. Isso permite que você expanda o número de registros que um diário ativo mantém sem precisar desativá-lo.

  • O diário de alterações pode crescer mais do que esse valor de destino, mas o diário de alterações é truncado no próximo ponto de verificação NTFS para menos do que esse valor. O NTFS examina o diário de alterações e o corta quando seu tamanho excede o valor de maxsize mais o valor de allocationdelta. Nos pontos de verificação NTFS, o sistema operacional grava registros no arquivo de log NTFS que permitem que o NTFS determine qual processamento é necessário para recuperar de uma falha.

  • O diário de alterações pode crescer para mais do que a soma dos valores de maxsize e allocationdelta antes de ser cortado.

  • Excluir ou desabilitar um diário de alterações ativo é muito demorado, porque o sistema deve acessar todos os registros na tabela de arquivos mestre (MFT) e definir o último atributo USN como 0 (zero). Esse processo pode levar vários minutos e pode continuar após a reinicialização do sistema, se uma reinicialização for necessária. Durante este processo, o diário de alterações não é considerado ativo, nem desativado. Enquanto o sistema está desativando o diário, ele não pode ser acessado e todas as operações do diário retornam erros. Você deve ter muito cuidado ao desativar um diário ativo, porque isso afeta negativamente outros aplicativos que estão usando o diário.

Examples

Para criar um diário de alterações USN na unidade C, digite:

fsutil usn createjournal m=1000 a=100 c:

Para excluir um diário de alterações USN ativo na unidade C, digite:

fsutil usn deletejournal /d c:

Para habilitar o rastreamento de intervalo com um tamanho de bloco e um limite de tamanho de arquivo especificados, digite:

fsutil usn enablerangetracking c=16384 s=67108864 C:

Para enumerar e listar as entradas do diário de alterações entre dois limites especificados na unidade C, digite:

fsutil usn enumdata 1 0 1 c:

Para consultar dados USN para um volume na unidade C, digite:

fsutil usn queryjournal c:

Para ler os dados USN de um arquivo na pasta \Temp na unidade C, digite:

fsutil usn readdata c:\temp\sample.txt

Para ler o diário USN com um USN inicial específico, digite:

fsutil usn readjournal startusn=0xF00