Freigeben über

Test-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

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

Dieses Cmdlet wird nur unter Windows unterstützt.

Syntax

Default (Standard) 

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 Unstimmigkeiten erkannt werden, wird der Status als ValidationFailed zurückgegeben. Benutzer können alle diese Informationen mithilfe des -Detailed Parameters abrufen. Dieser Parameter zeigt in der Signature-Eigenschaft auch den Signaturstatus des Katalogs an, was dem Aufruf des Cmdlets Get-AuthenticodeSignature in der Katalogdatei entspricht. Benutzer können auch jede Datei während der Überprüfung überspringen, indem Sie den parameter -FilesToSkip verwenden.

Dieses Cmdlet wird nur unter Windows unterstützt.

Beispiele

Beispiel 1: Erstellen 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: Validieren 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 zur Überprüfung zu verwendenden Hashes enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Detailed

Gibt weitere Informationen zu einem detaillierteren CatalogInformation-Objekt zurück, das die getesteten Dateien, deren erwartete/tatsächliche Hashes und eine Authenticode-Signatur der Katalogdatei enthält, wenn sie signiert ist.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FilesToSkip

Ein Array von Pfaden, die nicht als Teil der Überprüfung getestet werden sollten.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

DirectoryInfo

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 OR ValidValidationFailedenthält.

CatalogInformation

Ein detaillierteres Objekt, das bei der Verwendung -Detailed zurückgegeben wird und verwendet werden kann, um bestimmte Dateien zu analysieren, die die Validierung bestanden haben oder nicht, welche Hashes erwartet und gefunden wurden und welcher Algorithmus im Katalog verwendet wird.

Hinweise

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