Test-FileCatalog (Microsoft.PowerShell.Security)

Test-FileCatalog

Модуль:: Microsoft.PowerShell.Security

Test-FileCatalog проверяет, совпадают ли хэши, содержащиеся в файле каталога (.cat), с хэшами реальных файлов, чтобы подтвердить их подлинность.

Этот командлет поддерживается только в Windows.

Синтаксис

Test-FileCatalog
    [-Detailed]
    [-FilesToSkip <String[]>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

Test-FileCatalog проверяет подлинность файлов, сравнивая хэши файлов каталога (.cat) с хэшами реальных файлов на диске. Если он обнаруживает какие-либо несоответствия, он возвращает статус ValidationFailed. Пользователи могут получить всю эту информацию, используя параметр -Detailed. Он также отображает состояние подписи каталога в свойстве Signature, что эквивалентно вызову командлета Get-AuthenticodeSignature в файле каталога. Пользователи также могут пропустить любой файл во время проверки, используя параметр -FilesToSkip.

Этот командлет поддерживается только в Windows.

Примеры

Пример 1. Создание и проверка каталога файлов

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

Test-FileCatalog -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Valid

Пример 2. Проверка каталога файлов с подробным выводом

Test-FileCatalog -Detailed -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Status        : Valid
HashAlgorithm : SHA256
CatalogItems  : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
PathItems     : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
Signature     : System.Management.Automation.Signature

Параметры

-CatalogFilePath

Путь к файлу каталога (.cat), содержащему хэши, которые будут использоваться для проверки.

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

-Confirm

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

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

-Detailed

Возвращает дополнительную информацию в виде более подробного объекта CatalogInformation, который содержит проверенные файлы, их ожидаемые/фактические хэши и подпись Authenticode файла каталога, если он подписан.

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

-FilesToSkip

Массив путей, которые не следует проверять в рамках проверки.

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

-Path

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

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

-WhatIf

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

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

Входы

Информация о каталоге

Вы можете передать объект DirectoryInfo, представляющий путь к файлам, которые необходимо проверить.

Строка

Вы можете передать строку, представляющую путь к файлам, которые необходимо проверить.

Выходы

Статус проверки каталога

По умолчанию этот командлет возвращает объект CatalogValidationStatus со значением Valid или ValidationFailed.

Информация о каталоге

При использовании параметра Detailed командлет возвращает объект CatalogInformation для каждого файла, который можно использовать для анализа конкретных файлов, которые могли или не могли пройти проверку, хэши которых были ожидаемыми и найденными, а также алгоритм, использованный в каталоге.

Примечания

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