New-FileCatalog

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

このコマンドレットは、Windows platform.

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

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

$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

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

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

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

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