New-FileCatalog

  • Referencia
Módulo:
Microsoft.PowerShell.Security

New-FileCatalog crea un archivo de catálogo de hashes de archivo que se pueden usar para validar la autenticidad de un archivo.

Syntax

New-FileCatalog
   [-CatalogVersion <Int32>]
   [-CatalogFilePath] <String>
   [[-Path] <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

New-FileCatalog crea un archivo de catálogo de Windows para un conjunto de carpetas y archivos. Este archivo de catálogo contiene hashes para todos los archivos de las rutas de acceso proporcionadas. A continuación, los usuarios pueden distribuir el catálogo con sus archivos para que los usuarios puedan validar si se han realizado cambios en las carpetas desde la hora de creación del catálogo.

Se admiten las versiones 1 y 2 del catálogo. La versión 1 usa el algoritmo hash SHA1 (en desuso) para crear hashes de archivo y la versión 2 usa SHA256.

Ejemplos

Ejemplo 1: Crear un catálogo de archivos para "Microsoft.PowerShell.Utility"

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

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

Parámetros

-CatalogFilePath

Ruta de acceso a un archivo o carpeta donde se debe colocar el archivo de catálogo (.cat). Si se especifica una ruta de acceso de carpeta, se usará el nombre de archivo catalog.cat predeterminado.

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

-CatalogVersion

1.0 Acepta o 2.0 los valores posibles para especificar la versión del catálogo. 1.0 debe usarse evitado siempre que sea posible, ya que usa el algoritmo hash SHA-1 no seguro, mientras 2.0 que usa el algoritmo SHA-256 seguro Sin embargo, 1.0 es el único algoritmo admitido en Windows 7 y Server 2008R2.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-Path

Acepta una ruta de acceso o una matriz de rutas de acceso a archivos o carpetas que se deben incluir en el archivo de catálogo. Si se especifica una carpeta, también se incluirán todos los archivos de la carpeta.

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

String

Puede canalizar una cadena que se usa como nombre de archivo de catálogo a este cmdlet.

Salidas

FileInfo

Este cmdlet devuelve un objeto FileInfo que representa el catálogo creado.

Notas

Este cmdlet solo está disponible en plataformas Windows.