Compartir a través de

New-FileCatalog

Módulo:
Microsoft.PowerShell.Security Module

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

Sintaxis

Default (valor predeterminado) 

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

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-CatalogVersion

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

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.