新文件目录 (Microsoft.PowerShell.Security)

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

0

None

True

True

False

-CatalogVersion

接受 1.0 或 2.0 作为指定目录版本的可能值。应尽可能避免 1.0，因为它使用不安全的 SHA-1 哈希算法。版本 2.0 使用安全 SHA-256 算法。

整数32

命名

None

False

False

False

-Confirm

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

SwitchParameter

cf

命名

False

False

False

False

-Path

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

String[]

1

None

False

True

False

-WhatIf

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

SwitchParameter

wi

命名

False

False

False

False

输入

字符串

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

输出

文件信息

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

笔记

此 cmdlet 仅适用于 Windows 平台。