Поделиться через

New-FileCatalog

  • Ссылка
Модуль:
Microsoft.PowerShell.Security

Создает файл каталога Windows, содержащий криптографические хэши для файлов и папок в указанных путях.

Синтаксис

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

$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
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CatalogVersion

1.0 Принимает или 2.0 как можно больше значений для указания версии каталога. 1.0 следует избегать по возможности, так как он использует небезопасный хэш-алгоритм SHA-1. Версия 2.0 использует безопасный алгоритм SHA-256.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Принимает путь или массив путей к файлам или папкам, которые должны быть включены в файл каталога. Если указана папка, команда включает все файлы в папку.

Тип:String[]
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

Для этого командлета можно передать строку, используемую в качестве имени файла каталога.

Выходные данные

FileInfo

Этот командлет возвращает объект FileInfo , представляющий созданный каталог.

Примечания

Этот командлет доступен только на платформах Windows.