Test-FileCatalog

Test-FileCatalog 验证目录文件 (.cat) 中包含的哈希是否与实际文件的哈希匹配,以验证其真实性。

此 cmdlet 仅在 Windows 上受支持。

语法

Test-FileCatalog
    [-Detailed]
    [-FilesToSkip <String[]>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Test-FileCatalog 将目录文件 (.cat) 的文件哈希与磁盘上实际文件的哈希进行比较以验证文件的真实性。 如果检测到任何不匹配,它会返回 ValidationFailed 状态。 用户可通过使用 -Detailed 参数检索所有这些信息。 它还在 Signature 属性中显示目录的签名状态,该结果与针对目录文件调用 Get-AuthenticodeSignature cmdlet 的结果相同。 用户也可以使用 -FilesToSkip 参数在验证过程中跳过任何文件。

此 cmdlet 仅在 Windows 上受支持。

示例

示例 1:创建和验证文件目录

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

Test-FileCatalog -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Valid

示例 2:使用详细输出验证文件目录

Test-FileCatalog -Detailed -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Status        : Valid
HashAlgorithm : SHA256
CatalogItems  : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
PathItems     : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
Signature     : System.Management.Automation.Signature

参数

-CatalogFilePath

目录文件 (.cat) 的路径,其中包含要用于验证的哈希。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Detailed

返回详细信息,更详细的 CatalogInformation 对象,其中包含测试的文件、其预期/实际哈希,以及目录文件的 Authenticode 签名(如果已签名)。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FilesToSkip

不应作为验证的一部分进行测试的路径数组。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

应根据目录文件验证的文件夹或文件数组。

类型:String[]
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

DirectoryInfo

可以通过管道传递表示需验证的文件的路径的 DirectoryInfo 对象。

String

可以通过管道传递表示需验证的文件的路径的字符串。

输出

CatalogValidationStatus

默认情况下,此 cmdlet 返回 CatalogValidationStatus 对象,其值为 ValidValidationFailed

CatalogInformation

使用 Detailed 参数时,cmdlet 会为每个文件返回 CatalogInformation 对象,该对象可用于分析可能通过验证或可能尚未通过验证的特定文件、预期哈希与找到的哈希以及目录中使用的算法。

备注

此 cmdlet 仅在 Windows 平台上可用。