Condividi tramite

New-FileCatalog

Modulo:
Microsoft.PowerShell.Security Module

New-FileCatalog crea un file di catalogo di hash di file che può essere usato per convalidare l'autenticità di un file.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

New-FileCatalog crea un file di catalogo di Windows per un set di cartelle e file. Questo file di catalogo contiene hash per tutti i file nei percorsi specificati. Gli utenti possono quindi distribuire il catalogo con i file in modo che gli utenti possano verificare se sono state apportate modifiche alle cartelle dall'ora di creazione del catalogo.

Sono supportate le versioni 1 e 2 del catalogo. La versione 1 usa l'algoritmo hash SHA1 (deprecato) per creare hash di file e la versione 2 usa SHA256.

Esempio

Esempio 1: Creare un catalogo file per '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

Parametri

-CatalogFilePath

Percorso di un file o di una cartella in cui deve essere inserito il file di catalogo (con estensione cat). Se viene specificato un percorso di cartella, verrà utilizzato il nome catalog.cat file predefinito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-CatalogVersion

Accetta 1.0 o 2.0 i valori possibili per specificare la versione del catalogo. 1.0 dovrebbe essere utilizzato evitato quando possibile, in quanto utilizza l'algoritmo hash SHA-1 non sicuro, mentre 2.0 utilizza l'algoritmo sicuro SHA-256 Tuttavia, 1.0 è l'unico algoritmo supportato su Windows 7 e Server 2008R2.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Accetta un percorso o una matrice di percorsi per file o cartelle che devono essere inclusi nel file di catalogo. Se viene specificata una cartella, verranno inclusi anche tutti i file in essa contenuti.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

È possibile reindirizzare una stringa utilizzata come nome del file di catalogo a questo cmdlet.

Output

FileInfo

Questo cmdlet restituisce un oggetto FileInfo che rappresenta il catalogo creato.

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.