New-FileCatalog
New-FileCatalog
は、ファイルの信頼性を検証するために使用できるファイル ハッシュのカタログ ファイルを作成します。
構文
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' のファイル カタログをCreateする
New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 11/2/2018 11:58 AM 950 Microsoft.PowerShell.Utility.cat
パラメーター
-CatalogFilePath
カタログ ファイル (.cat) を配置する必要があるファイルまたはフォルダーへのパス。 フォルダー パスを指定すると、既定のファイル名 catalog.cat
が使用されます。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CatalogVersion
カタログ バージョンを 1.0
指定するために、または 2.0
可能な値を受け入れます。 1.0
セキュリティで保護された SHA-256 アルゴリズムを使用します 2.0
が、Windows 7 と Server 2008R2 でサポートされている唯一のアルゴリズムは、セキュリティで保護されていない SHA-1 ハッシュ アルゴリズムを使用するため、 1.0
可能な限り使用しないでください。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
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 |
入力
カタログ ファイル名として使用される文字列をこのコマンドレットにパイプできます。
出力
このコマンドレットは、作成されたカタログを表す FileInfo オブジェクトを返します。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。