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。

示例

示例 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
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CatalogVersion

接受 1.0 或 2.0 指定目录版本的可能值。应尽可能避免使用 1.0，因为它使用不安全的 SHA-1 哈希算法，而 2.0 使用安全的 SHA-256 算法，但 1.0 是 Windows 7 和 Server 2008R2 上唯一受支持的算法。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

接受目录文件中包含的文件或文件夹的路径或路径数组。如果指定了文件夹，该文件夹中的所有文件也将包括在内。

类型:	String[]
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

可以通过管道将用作目录文件名的字符串传递给此 cmdlet。

输出

FileInfo

此 cmdlet 返回表示所创建目录的 FileInfo 对象。

备注

此 cmdlet 仅在 Windows 平台上可用。

通过