Compartir a través de

Test-FileCatalog

  • Referencia
Módulo:
Microsoft.PowerShell.Security

Test-FileCatalog valida si los hashes contenidos en un archivo de catálogo (.cat) coinciden con los hash de los archivos reales para validar su autenticidad.

Este cmdlet solo se admite en Windows.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

Test-FileCatalog valida la autenticidad de los archivos comparando los hashes de archivo de un archivo de catálogo (.cat) con los hashes de los archivos reales en el disco. Si detecta errores de coincidencia, devuelve el estado ValidationFailed. Los usuarios pueden recuperar toda esta información mediante el parámetro -Detailed. También muestra el estado de firma del catálogo en la propiedad Signature, que equivale a llamar a Get-AuthenticodeSignature cmdlet en el archivo de catálogo. Los usuarios también pueden omitir cualquier archivo durante la validación mediante el parámetro -FilesToSkip.

Este cmdlet solo se admite en Windows.

Ejemplos

Ejemplo 1: Creación y validación de un catálogo de archivos

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

Ejemplo 2: Validación de un catálogo de archivos con salida detallada

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

Parámetros

-CatalogFilePath

Ruta de acceso a un archivo de catálogo (.cat) que contiene los hash que se van a usar para la validación.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Detailed

Devuelve más información un objeto CatalogInformation más detallado que contiene los archivos probados, sus hash esperados o reales y una firma Authenticode del archivo de catálogo si está firmado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FilesToSkip

Matriz de rutas de acceso que no se deben probar como parte de la validación.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Carpeta o matriz de archivos que se deben validar en el archivo de catálogo.

Tipo:String[]
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

DirectoryInfo

Puede canalizar un objeto DirectoryInfo que representa la ruta de acceso a los archivos que deben validarse.

String

Puede canalizar una cadena que representa la ruta de acceso a los archivos que deben validarse.

Salidas

CatalogValidationStatus

De forma predeterminada, este cmdlet devuelve un objeto CatalogValidationStatus con un valor de Valid o ValidationFailed.

CatalogInformation

Cuando se usa el parámetro Detailed, el cmdlet devuelve un objeto CatalogInformation para cada archivo, que se puede usar para analizar archivos específicos que pueden o no haber superado la validación, qué hash se esperaba y el algoritmo usado en el catálogo.

Notas

Este cmdlet solo está disponible en plataformas Windows.