Condividi tramite

Test-FileCatalog

  • Riferimento
Modulo:
Microsoft.PowerShell.Security

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

Questo cmdlet è supportato solo in Windows.

Sintassi

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

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 cmdlet nel file di catalogo. Gli utenti possono anche ignorare qualsiasi 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 CatalogInformation più dettagliato 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 cosa accadrebbe se il cmdlet viene eseguito. 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 oggetto DirectoryInfo che rappresenta il percorso ai file da convalidare.

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 Valid o ValidationFailed.

CatalogInformation

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

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.