Test-FileCatalog

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

Test-FileCatalog は、カタログ ファイル (.cat) のファイル ハッシュとディスク上の実際のファイルのハッシュを比較することで、ファイルの信頼性を検証します。 不一致が検出されると、状態が ValidationFailed として返されます。 ユーザーは、-Detailed パラメーターを使用して、この情報をすべて取得できます。 また、Signature プロパティにカタログの署名状態も表示されます。これは、カタログ ファイルでコマンドレット Get-AuthenticodeSignature 呼び出すことと同じです。 ユーザーは、-FilesToSkip パラメーターを使用して、検証中に任意のファイルをスキップすることもできます。

このコマンドレットは、Windows でのみサポートされています。

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

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

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

検証する必要があるファイルへのパスを表す DirectoryInfo オブジェクトをパイプ処理できます。

検証する必要があるファイルへのパスを表す文字列をパイプ処理できます。

既定では、このコマンドレットは、 または Validのいずれかの値を持つ ValidationFailed オブジェクトを返します。

Detailed パラメーターを使用すると、コマンドレットは各ファイルの CatalogInformation オブジェクトを返します。このオブジェクトを使用して、検証に合格した可能性がある特定のファイル、予想されたハッシュと検出されたハッシュ、カタログで使用されたアルゴリズムを分析できます。