Condividi tramite

Test-FileCatalog

  • Riferimento
Modulo:
Microsoft.PowerShell.Security

Test-FileCatalog verifica se gli hash contenuti in un file di catalogo (con estensione cat) corrispondono agli hash dei file effettivi per convalidarne l'autenticità.

Questo cmdlet è supportato solo in Windows.

Sintassi

Test-FileCatalog
    [-Detailed]
    [-FilesToSkip <String[]>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Test-FileCatalog convalida l'autenticità dei file confrontando gli hash dei file di un file di catalogo (cat) con gli hash dei file effettivi su disco. Se rileva eventuali mancate corrispondenze, restituisce lo stato ValidationFailed. Gli utenti possono recuperare tutte queste informazioni usando il parametro -Detailed. Visualizza anche lo stato della firma del catalogo nella proprietà Signature che equivale a chiamare Get-AuthenticodeSignature il cmdlet nel file di catalogo. Gli utenti possono inoltre ignorare alcuni file durante la convalida usando il parametro - FilesToSkip.

Questo cmdlet è supportato solo in Windows.

Esempio

Esempio 1: Creare e convalidare un catalogo file

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

Test-FileCatalog -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Valid

Esempio 2: Convalidare un catalogo file con output dettagliato

Test-FileCatalog -Detailed -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHome\Modules\Microsoft.PowerShell.Utility\"

Status        : Valid
HashAlgorithm : SHA256
CatalogItems  : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
PathItems     : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
Signature     : System.Management.Automation.Signature

Parametri

-CatalogFilePath

Percorso di un file di catalogo (con estensione cat) che contiene gli hash da utilizzare per la convalida.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Detailed

Restituisce altre informazioni un oggetto più dettagliato CatalogInformation che contiene i file testati, gli hash previsti/effettivi e una firma Authenticode del file di catalogo, se firmato.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FilesToSkip

Matrice di percorsi che non devono essere testati come parte della convalida.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Cartella o matrice di file che devono essere convalidati rispetto al file di catalogo.

Tipo:String[]
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

DirectoryInfo

È possibile inviare tramite pipe un DirectoryInfo oggetto che rappresenta il percorso ai file che devono essere convalidati.

String

È possibile inviare tramite pipe una stringa che rappresenta il percorso ai file che devono essere convalidati.

Output

CatalogValidationStatus

Per impostazione predefinita, questo cmdlet restituisce un oggetto CatalogValidationStatus con un valore o Valid ValidationFailed.

CatalogInformation

Quando si usa il parametro Detailed , il cmdlet restituisce un oggetto CatalogInformation per ogni file, che può essere usato per analizzare file specifici che possono o non hanno superato la convalida, che sono stati previsti hash e che l'algoritmo usato nel catalogo.