Compartir a través de

New-FileCatalog

  • Referencia
Módulo:
Microsoft.PowerShell.Security

Crea un archivo de catálogo de Windows que contiene hash criptográficos para archivos y carpetas en las rutas de acceso especificadas.

Sintaxis

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"

$newFileCatalogSplat = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = '\temp\Microsoft.PowerShell.Utility.cat'
    CatalogVersion = 2.0
}
New-FileCatalog @newFileCatalogSplat

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

Parámetros

-CatalogFilePath

Ubicación y nombre del archivo de catálogo (.cat) que está creando. Si especifica solo una ruta de acceso de carpeta, el comando crea un archivo denominado catalog.cat en esa ubicación.

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

-CatalogVersion

1.0 Acepta o 2.0 los valores posibles para especificar la versión del catálogo. 1.0 debe evitarse siempre que sea posible porque usa el algoritmo hash SHA-1 no seguro. La versión 2.0 usa el algoritmo SHA-256 seguro.

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

-Confirm

Le solicita su 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

-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, el comando incluye todos los archivos de la carpeta.

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 se ejecutara el cmdlet. 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

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.