Condividi tramite

New-FileCatalog

  • Riferimento
Modulo:
Microsoft.PowerShell.Security

Crea un file di catalogo di Windows contenente hash crittografici per file e cartelle nei percorsi specificati.

Sintassi

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'

$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

Parametri

-CatalogFilePath

Percorso e nome del file di catalogo (.cat) che si sta creando. Se si specifica solo un percorso di cartella, il comando crea un file denominato catalog.cat in tale percorso.

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

-CatalogVersion

Accetta 1.0 o 2.0 il più possibile valori per specificare la versione del catalogo. 1.0 deve essere evitato quando possibile perché usa l'algoritmo hash SHA-1 non sicuro. Version 2.0 usa l'algoritmo SHA-256 sicuro.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Accetta un percorso o una matrice di percorsi per file o cartelle che devono essere inclusi nel file di catalogo. Se si specifica una cartella, il comando include tutti i file nella cartella .

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

È possibile inviare tramite pipe una stringa usata come nome file del 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.