Test-FileCatalog
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
Puede canalizar un DirectoryInfo
objeto que representa la ruta de acceso a los archivos que deben validarse.
Puede canalizar una cadena que representa la ruta de acceso a los archivos que deben validarse.
Salidas
De forma predeterminada, este cmdlet devuelve un objeto CatalogValidationStatus con un valor de Valid
o ValidationFailed
.
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.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de