New-FileCatalog (Microsoft.PowerShell.Security)

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
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-CatalogVersion

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

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Path

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

Тип :: String[]
Позиция:: 1
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-WhatIf

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

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

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

Выходы

Информация о файле

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

Примечания

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