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 ihre 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 ein Konflikt erkannt wird, wird der Status als ValidationFailed zurückgegeben. Benutzer können alle diese Informationen mithilfe des -Detailed Parameters abrufen. Außerdem wird der Signaturstatus des Katalogs in der Signatureigenschaft angezeigt, das dem Aufrufen Get-AuthenticodeSignature Cmdlets 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: Ü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 zur Überprüfung zu verwendenden Hashes enthält.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FilesToSkip

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

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

Typ:	String[]
Position:	1
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

DirectoryInfo

Sie können ein DirectoryInfo -Objekt, das den Pfad zu den Dateien darstellt, die überprüft werden müssen, weitergeleitet werden.

String

Sie können eine Zeichenfolge übergeben, die den Pfad zu den Dateien darstellt, die überprüft werden müssen.

Ausgaben

CatalogValidationStatus

Standardmäßig gibt dieses Cmdlet ein CatalogValidationStatus- -Objekt mit dem Wert Valid oder ValidationFailedzurück.

CatalogInformation

Wenn Sie den Parameter "Detailed" verwenden, gibt das Cmdlet ein CatalogInformation- Objekt für jede Datei zurück, das verwendet werden kann, um bestimmte Dateien zu analysieren, die möglicherweise eine Überprüfung bestanden haben, welche Hashes im Vergleich zu gefunden wurden, und den im Katalog verwendeten Algorithmus.

Hinweise

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

Freigeben über