New-FileCatalog
指定したパス内のファイルとフォルダーの暗号化ハッシュを含む Windows カタログ ファイルを作成します。
構文
Default (既定)
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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-CatalogVersion
カタログ バージョンを指定するために、1.0 または 2.0 可能な値を受け入れます。
1.0 は、セキュリティで保護されていない SHA-1 ハッシュ アルゴリズムを使用するため、可能な限り避ける必要があります。 バージョン 2.0 では、セキュリティで保護された SHA-256 アルゴリズムが使用されます。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
カタログ ファイルに含める必要があるファイルまたはフォルダーへのパスまたはパスの配列を受け入れます。 フォルダーが指定されている場合、コマンドにはフォルダー内のすべてのファイルが含まれます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
String
カタログ ファイル名として使用される文字列をこのコマンドレットにパイプできます。
出力
FileInfo
このコマンドレットは、作成されたカタログを表す FileInfo オブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。