New-FileCatalog

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.

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"

$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.

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 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.

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, el comando incluye 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.

Vínculos relacionados

• Test-FileCatalog
• PowerShellGet