Share via

New-FileCatalog

  • 參考
模組:
Microsoft.PowerShell.Security

New-FileCatalog 會建立檔案哈希的目錄檔案，可用來驗證檔案的真實性。

Syntax

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

Description

此 Cmdlet 僅適用於 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-1哈希演算法，而 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

執行 Cmdlet 之前先提示您確認。

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

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

您可以使用管線將做為目錄檔名的字串傳送至此 Cmdlet。

輸出

FileInfo

此 Cmdlet 會傳 回代表所建立目錄的 FileInfo 物件。

備註

此 Cmdlet 僅適用於 Windows 平臺。