< Back

Repair-FileIntegrity

Wed Jan 30, 2019 6:03 pm

NAME Repair-FileIntegrity



SYNOPSIS

Repairs a corrupted file on an NTFS or ReFS volume.





SYNTAX

Repair-FileIntegrity [-FileName] <String> [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The Repair-FileIntegrity cmdlet repairs a corrupted file on an NTFS file system volume or a Resilient File System (ReFS) volume. For the cmdlet to

repair a file, the file must be on a storage volume that provides redundancy, and the file must have integrity turned on. This cmdlet does not repair

corrupted file metadata.





PARAMETERS

-CimSession [<CimSession[]>]

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or

Get-CimSession cmdlet. The default is the current session on the local computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-FileName <String>

Specifies a file name. The cmdlet attempts to repair the file that you specify.



Required? true

Position? 1

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ThrottleLimit [<Int32>]

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is

entered, then Windows PowerShell???? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the

computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value false

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value false

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.IO.FileInfo

http://msdn.microsoft.com/library/syste ... .110).aspx





To obtain a FileInfo object, use the Get-Item cmdlet for a specified file name. The cmdlet uses the FullName property as the value of the FileName

parameter.



System.IO.DirectoryInfo

http://msdn.microsoft.com/library/syste ... .110).aspx





To obtain a DirectoryInfo object, use Get-Item for a specified directory name. The cmdlet uses the FullName property as the value of the FileName

parameter.





OUTPUTS





This cmdlet generates no output.





Example 1: Repair a file



PS C:\\>Repair-FileIntegrity -FileName 'H:\\Temp\\Text Document.txt'



This command repairs a file. Because the repair proceeds without error, the cmdlet does not display any message.





Example 2: Attempt to repair a file that cannot be repaired



PS C:\\>Repair-FileIntegrity -FileName 'J:\\Temp\\Text Document.txt'

Repair-FileIntegrity : The storage device does not provide redundancy.



This command attempts to repair a file. In this example, the cmdlet cannot repair the file and therefore displays an explanation.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=816468

Get-FileIntegrity

Set-FileIntegrity