Compartilhar via


fsutil file

Localiza um arquivo por nome de usuário (se as Cotas de Disco estiverem habilitadas), consulta intervalos alocados para um arquivo, define o nome curto de um arquivo, define o comprimento de dados válido de um arquivo, define zero dados para um arquivo ou cria um arquivo.

Sintaxe

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>

Parâmetros

Parâmetro Descrição
createnew Cria um arquivo com o nome e o tamanho especificados, com conteúdo que consiste em zeros.
<length> Especifica o comprimento de dados válido do arquivo.
findbysid Localiza arquivos que pertencem a um usuário especificado em volumes NTFS em que as Cotas de Disco estão habilitadas.
<username> Especifica o nome de usuário ou o nome de logon do usuário.
<directory> Especifica o caminho completo para o diretório, por exemplo, C:\users.
optimizemetadata Executa uma compactação imediata dos metadados para um determinado arquivo.
/a Analise os metadados do arquivo antes e depois da otimização.
queryallocranges Consulta os intervalos alocados para um arquivo em um volume NTFS. Útil para determinar se um arquivo tem regiões esparsas.
offset=<offset> Especifica o início do intervalo que deve ser definido como zeros.
length=<length> Especifica o comprimento do intervalo (em bytes).
queryextents Consulta as extensões de um arquivo.
/r Se <filename> for um ponto de nova análise, abra-o em vez de seu destino.
<startingvcn> Especifica o primeiro VCN a ser consultado. Se omitido, comece no VCN 0.
<numvcns> Número de VCNs a serem consultados. Se omitido ou 0, consulte até EOF.
queryfileid Consulta a ID de um arquivo em um volume NTFS.
<volume> Especifica o volume como o nome da unidade, seguido de dois-pontos.
queryfilenamebyid Exibe um nome de link aleatório para uma ID de arquivo especificada em um volume NTFS. Como um arquivo pode ter mais de um nome de link apontando para esse arquivo, não é garantido qual link de arquivo será fornecido como resultado da consulta para o nome do arquivo.
<fileid> Especifica a ID do arquivo em um volume NTFS.
queryoptimizemetadata Consulta o estado de metadados de um arquivo.
queryvaliddata Consulta o comprimento de dados válido de um arquivo.
/d Exibe informações detalhadas de dados válidos.
seteof Define o EOF do arquivo especificado.
setshortname Define o nome abreviado (nome de arquivo de 8,3 caracteres) para um arquivo em um volume NTFS.
<shortname> Especifica o nome abreviado do arquivo.
setvaliddata Define o comprimento de dados válido para um arquivo em um volume NTFS.
<datalength> Especifica o comprimento do tamanho em bytes.
setzerodata Define um intervalo (especificado por deslocamento e comprimento) do arquivo como zeros, o que esvazia o arquivo. Se o arquivo for um arquivo esparso, as unidades de alocação subjacentes serão descompactadas.

Comentários

  • No NTFS, há dois conceitos importantes de comprimento de arquivo: o marcador EOF (fim do arquivo) e o VDL (Comprimento de dados válido). EOF indica o comprimento real do arquivo. VDL identifica o comprimento dos dados válidos no disco. Qualquer leitura entre VDL e EOF retorna automaticamente 0 para preservar o requisito de reutilização de objeto C2.

  • O parâmetro setvaliddata só está disponível para administradores porque requer o privilégio Executar tarefas de manutenção de volume (SeManageVolumePrivilege). Esse recurso só é necessário para cenários avançados de multimídia e de rede de área do sistema. O parâmetro setvaliddata precisa ser um valor positivo maior que o VDL atual, mas menor que o tamanho do arquivo atual.

    É útil para os programas definir um VDL ao:

    • Gravar clusters brutos diretamente no disco por meio de um canal de hardware. Isso permite que o programa informe ao sistema de arquivos que esse intervalo contém dados válidos que podem ser retornados ao usuário.

    • Criar arquivos grandes quando o desempenho é um problema. Isso evita o tempo necessário para preencher o arquivo com zeros quando o arquivo é criado ou estendido.

Exemplos

Para localizar arquivos que pertencem a scottb na unidade C, digite:

fsutil file findbysid scottb c:\users

Para consultar os intervalos alocados para um arquivo em um volume NTFS, digite:

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

Para otimizar os metadados para um arquivo, digite:

fsutil file optimizemetadata C:\largefragmentedfile.txt

Para consultar as extensões de um arquivo, digite:

fsutil file queryextents C:\Temp\sample.txt

Para definir o EOF de um arquivo, digite:

fsutil file seteof C:\testfile.txt 1000

Para definir o nome abreviado do arquivo, longfilename.txt na unidade C como longfile.txt, digite:

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

Para definir o comprimento de dados válido como 4096 bytes para um arquivo chamado testfile.txt em um volume NTFS, digite:

fsutil file setvaliddata c:\testfile.txt 4096

Para definir um intervalo de um arquivo em um volume NTFS como zeros para esvaziá-lo, digite:

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