New-FileCatalog

创建一个 Windows 目录文件,其中包含指定路径中文件和文件夹的加密哈希。

语法

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”创建文件目录

$newFileCatalogSplat = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = '\temp\Microsoft.PowerShell.Utility.cat'
    CatalogVersion = 2.0
}
New-FileCatalog @newFileCatalogSplat

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.02.0 作为可能值,用于指定目录版本。 1.0 应尽可能避免,因为它使用不安全的 SHA-1 哈希算法。 版本 2.0 使用安全的 SHA-256 算法。

类型: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 平台上可用。