次の方法で共有

Test-FileCatalog

  • リファレンス
モジュール:
Microsoft.PowerShell.Security

Test-FileCatalog は、カタログ ファイル (.cat) に含まれるハッシュが、信頼性を検証するために実際のファイルのハッシュと一致するかどうかを検証します。

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

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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

このコマンドレットは、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
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Detailed

テストされたファイル、予期されるハッシュ/実際のハッシュ、およびカタログ ファイルの Authenticode 署名 (署名されている場合) を含む、より詳細な CatalogInformation オブジェクトを返します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FilesToSkip

検証の一部としてテストすべきではないパスの配列。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

カタログ ファイルに対して検証する必要があるファイルのフォルダーまたは配列。

型:String[]
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

DirectoryInfo

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

String

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

出力

CatalogValidationStatus

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

CatalogInformation

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

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。