New-FileCatalog
New-FileCatalog
创建可用于验证文件真实性的文件哈希目录文件。
语法
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
此 cmdlet 仅在 Windows 平台上可用。
New-FileCatalog
为一组文件夹和 文件创建 Windows 目录文件 。 此目录文件包含所提供路径中所有文件的哈希。 然后,用户可以使用其文件分发目录,以便用户可以验证自创建目录以来是否对文件夹进行了任何更改。
支持目录版本 1 和 2。 版本 1 使用 (弃用) SHA1 哈希算法来创建文件哈希,版本 2 使用 SHA256。
示例
示例 1:Create“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 |
输入
可以通过管道将用作目录文件名的字符串传递给此 cmdlet。
输出
此 cmdlet 返回表示所创建目录的 FileInfo 对象。
备注
此 cmdlet 仅在 Windows 平台上可用。