New-FileCatalog
New-FileCatalog
создает файл каталога хэшей файлов, которые можно использовать для проверки подлинности файла.
Синтаксис
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе 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
Запрос подтверждения перед выполнением командлета.
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
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Для этого командлета можно передать строку, используемую в качестве имени файла каталога.
Выходные данные
Этот командлет возвращает объект FileInfo , представляющий созданный каталог.
Примечания
Этот командлет доступен только на платформах Windows.
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по