New-FileCatalog
New-FileCatalog 建立檔案哈希的目錄檔案，可用來驗證檔案的真實性。
語法
Default (預設值)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
New-FileCatalog 會為一組資料夾和檔案建立 Windows 目錄檔案。 此目錄檔案包含所提供路徑中所有檔案的哈希。 然後，使用者可以將目錄與其檔案一起散發，讓使用者可以驗證自目錄建立時間以來是否已對資料夾進行任何變更。
支援類別目錄版本 1 和 2。 第 1 版會使用 （已淘汰） SHA1 哈希演算法來建立檔案哈希，而第 2 版則使用 SHA256。 Windows Server 2008 R2 或 Windows 7 不支持目錄版本 2。 應在 Windows 8、Windows Server 2012 及更高版本的作系統上使用目錄版本 2。
範例
範例 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 。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-CatalogVersion
接受 1.0 或 2.0 指定目錄版本的可能值。
1.0 應盡可能避免使用，因為它使用不安全的SHA-1哈希演算法，同時 2.0 使用安全的SHA-256演算法但是， 1.0 是Windows 7和Server 2008R2上唯一支援的演算法。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
接受目錄檔案中應包含之檔案或資料夾的路徑或路徑陣列。 如果指定了資料夾，則該資料夾中的所有檔也將包含在內。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
管道採用用作目錄檔名的字串。
輸出
FileInfo
備註
此 Cmdlet 僅適用於 Windows 平臺。