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:为“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 平台上可用。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈