CmdID

CmdID / Commands / refsutil

refsutil salvage

The refsutil salvage command attempts to diagnose severely damaged Resilient File System (ReFS) volumes. Windows commands reference

On Windows

Opens CmdID with your command. It is read in your browser and sent nowhere.

Windows

from the Windows commands reference, CC BY 4.0

The refsutil salvage command attempts to diagnose severely damaged Resilient File System (ReFS) volumes. It works by identifying files that remain intact despite the damage. Once these recoverable files are identified, the tool copies them to a different, specified volume. The refsutil salvage tool operates in two phases, Scan Phase and Copy Phase: - Scan Phase: Involves diagnosing the damaged ReFS volume and identifying recoverable files. In manual mode, you're able to pause and resume this phase. Progress and logs are stored in the working directory, allowing you to continue the scan from where it was left off. - Copy Phase: Involves copying the identified recoverable files to a specified target volume. This phase can be run independently in manual mode. Logs and progress for this phase are also saved in the working directory. In automatic mode, both the Scan Phase and Copy Phase run sequentially without user intervention. All progress and logs are saved in the working directory, ensuring that the process can be monitored and managed efficiently. You typically don't need to use the refsutil salvage tool unless the volume appears as RAW, indicating corruption. If the volume is in a read-only state, the data is still accessible and can be retrieved without this tool. NOTE: The refsutil salvage command is only supported in the following operating systems: - Windows 10 Pro for Workstations or later - Windows Server 2019 or later In repairing ReFS volumes, two modes are featured, Automatic Mode and Manual Mode. Automatic Mode scans and repairs the volume automatically without user intervention, while Manual Mode offers advanced users detailed control over the repair process, allowing them to review and decide on specific actions.

refsutil salvage -QA | -FA | -C <source volume> <working directory> <target directory> <options>
refsutil salvage -D | -QS | -FS | -IC <source volume> <working directory> <options>
refsutil salvage -SL <source volume> <working directory> <target directory> <file list> <options>

To perform an automatic quick analysis scan, which quickly checks the volume for issues and attempts repairs without user input, run this command

refsutil salvage -QA E: C:\TempIdentify

To perform a full analysis scan automatically, which thoroughly checks the volume for issues and attempts repairs without user input, run this command

refsutil salvage -FA E: C:\TempIdentify

To perform a comprehensive scan with user control, allowing you to review and decide on specific actions during the repair process, run this command

refsutil salvage -C E: C:\Temp D:\RecoveredIdentify

To perform a quick scan that provides a detailed report of the issues found, enabling verbose logging for more information, run this command

refsutil salvage -QS E: C:\Temp -vIdentify

To skip the version check during a full scan, which assumes the highest volume version that the tool can handle (useful if you know the tool is compatible with your volume), run this command

refsutil salvage -FS E: C:\Temp -svIdentify

To salvage specific files listed in a file list, created during the Scan Phase, and to force dismount the volume if necessary, run this command

refsutil salvage -SL E: C:\Temp D:\Recovered FileList.txt -xIdentify
<source volume>Specifies the ReFS volume to process in the format E: or the path to the volume mount point.
<working directory>Specifies the location to store temporary information and logs. It must not be located on the <source volume>.
<target directory>Specifies the location where identified files are copied to. It must not be located on the <source volume>.
<file list>Specifies a file containing a list of specific files to be salvaged from the source volume to the target directory. This file must be generated during the Scan Phase using the foundfiles.<volume signature>.txt file.
<options>- -m: Recovers all possible files, including deleted ones. - -v: Specifies to use verbose mode for detailed logging. - -sv: Skips the ReFS volume version check and assume the highest volume version that this tool can handle. - -hl: Assumes that the volume supports hard links. - -x: Forces the volume to dismount first, if necessary. All opened handles to the volume are then invalid.