New-FileCatalog
指定したパス内のファイルとフォルダーの暗号化ハッシュを含む 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 |
入力
カタログ ファイル名として使用される文字列をこのコマンドレットにパイプできます。
出力
このコマンドレットは、作成されたカタログを表す FileInfo オブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
関連リンク
PowerShell