通过

New-FileCatalog

  • 参考
模块:
Microsoft.PowerShell.Security

New-FileCatalog 创建可用于验证文件真实性的文件哈希目录文件。

语法

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

说明

此 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：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

输入

String

管道采用用作目录文件名的字符串。

输出

FileInfo

备注

此 cmdlet 仅在 Windows 平台上可用。