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' のファイル カタログを作成する
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
で、セキュリティで保護された SHA-256 アルゴリズムを使用するため、可能な限り避けてください。ただし、 1.0
Windows 7 および Server 2008R2 でサポートされている唯一のアルゴリズムです。
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 プラットフォームでのみ使用できます。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示