Share via

Test-FileCatalog

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

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

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

構文

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

説明

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilesToSkip

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

DirectoryInfo

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

String

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

出力

CatalogValidationStatus

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

CatalogInformation

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