Share via

Test-FileCatalog

  • Referenz
Modul:
Microsoft.PowerShell.Security

Test-FileCatalog überprüft, ob die in einer Katalogdatei (.cat) enthaltenen Hashes mit den Hashes der tatsächlichen Dateien übereinstimmen, um deren Authentizität zu überprüfen.

Dieses Cmdlet wird nur unter Windows unterstützt.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Test-FileCatalog überprüft die Authentizität von Dateien, indem die Dateihashes einer Katalogdatei (.cat) mit den Hashes der tatsächlichen Dateien auf dem Datenträger verglichen werden. Wenn es Nichtübereinstimmungen erkennt, gibt er den status als ValidationFailed zurück. Benutzer können alle diese Informationen mithilfe des Parameters -Detailed abrufen. Außerdem werden signierende status des Katalogs in der Signatureigenschaft angezeigt, was dem Aufrufen Get-AuthenticodeSignature des Cmdlets für die Katalogdatei entspricht. Benutzer können außerdem jede Datei während der Überprüfung mithilfe des Parameters -FilesToSkip überspringen.

Dieses Cmdlet wird nur unter Windows unterstützt.

Beispiele

Beispiel 1: Create und Überprüfen eines Dateikatalogs

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

Beispiel 2: Überprüfen eines Dateikatalogs mit detaillierter Ausgabe

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

Parameter

-CatalogFilePath

Ein Pfad zu einer Katalogdatei (.cat), die die hashes enthält, die für die Überprüfung verwendet werden sollen.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Detailed

Gibt weitere Informationen aus einem ausführlicheren CatalogInformation Objekt zurück, das die getesteten Dateien, ihre erwarteten/tatsächlichen Hashes und eine Authenticode-Signatur der Katalogdatei enthält, wenn sie signiert ist.

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

-FilesToSkip

Ein Array von Pfaden, die nicht im Rahmen der Validierung getestet werden sollten.

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

-Path

Ein Ordner oder Array von Dateien, die anhand der Katalogdatei überprüft werden sollen.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

DirectoryInfo[], System.String[]

Die Pipeline akzeptiert ein Array von Zeichenfolgen oder DirectoryInfo Objekten, die Pfade zu den Dateien darstellen, die überprüft werden müssen.

Ausgaben

CatalogValidationStatus

Der Standardrückgabetyp, der den Wert oder ValidValidationFailedenthält.

CatalogInformation

Ein ausführlicheres Objekt, das bei Verwendung -Detailed von zurückgegeben wird, das verwendet werden kann, um bestimmte Dateien zu analysieren, die die Überprüfung bestanden haben oder nicht, welche Hashes erwartet wurden und welche Hashes gefunden wurden, und den im Katalog verwendeten Algorithmus.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.