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.

Syntax

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 es equivalente a llamar Get-AuthenticodeSignature al cmdlet en el archivo de catálogo. El usuario también puede 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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilesToSkip

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DirectoryInfo

Puede canalizar un DirectoryInfo objeto 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, que se esperaban hashes y el algoritmo usado en el catálogo.

Notas

Este cmdlet solo está disponible en plataformas Windows.