fsutil file
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8
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