New-FileCatalog

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

指定したパス内のファイルとフォルダーの暗号化ハッシュを含む Windows カタログ ファイルを作成します。

構文

New-FileCatalog
   [-CatalogVersion <Int32>]
   [-CatalogFilePath] <String>
   [[-Path] <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

New-FileCatalogは、フォルダーとファイルのセットに対してWindows カタログ ファイルを作成します。 このカタログ ファイルには、指定されたパス内のすべてのファイルのハッシュが含まれています。 その後、ユーザーはカタログをファイルと共に配布して、カタログの作成時以降にフォルダーに変更が加えられたかどうかを検証できます。

カタログ バージョン 1 と 2 がサポートされています。 バージョン 1 では、(非推奨の) SHA1 ハッシュ アルゴリズムを使用してファイル ハッシュを作成し、バージョン 2 では SHA256 を使用します。

例

例 1: 'Microsoft.PowerShell.Utility' のファイル カタログを作成する

$newFileCatalogSplat = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = '\temp\Microsoft.PowerShell.Utility.cat'
    CatalogVersion = 2.0
}
New-FileCatalog @newFileCatalogSplat

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

パラメーター

-CatalogFilePath

作成するカタログ ファイル (.cat) の場所と名前。 フォルダー パスのみを指定した場合、コマンドはその場所に catalog.cat という名前のファイルを作成します。

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

-CatalogVersion

カタログ バージョンを指定するために、 1.0 または 2.0 可能な値を受け入れます。 1.0 は、セキュリティで保護されていない SHA-1 ハッシュ アルゴリズムを使用するため、可能な限り避ける必要があります。 バージョン 2.0 では、セキュリティで保護された SHA-256 アルゴリズムが使用されます。

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

-Confirm

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

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

-Path

カタログ ファイルに含める必要があるファイルまたはフォルダーへのパスまたはパスの配列を受け入れます。 フォルダーが指定されている場合、コマンドにはフォルダー内のすべてのファイルが含まれます。

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

-WhatIf

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

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

入力

String

カタログ ファイル名として使用される文字列をこのコマンドレットにパイプできます。

出力

FileInfo

このコマンドレットは、作成されたカタログを表す FileInfo オブジェクトを返します。

メモ

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