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

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 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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-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.

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

-FilesToSkip

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

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

-Path

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

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

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 ValidValidationFailed.

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.

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.