Test-FileCatalog
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
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 abweichungen erkannt werden, gibt es 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 Signature-Eigenschaft 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 -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 eines detaillierteren CatalogInformation
Objekts 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 Überprüfung 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 sollten.
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
Der Standardrückgabetyp, der einen Wert von oder Valid
ValidationFailed
enthält.
Ein detaillierteres Objekt, das bei Verwendung -Detailed
zurückgegeben wird, das verwendet werden kann, um bestimmte Dateien zu analysieren, die möglicherweise die Überprüfung bestanden haben, welche Hashes im Vergleich zum Gefundenen erwartet wurden, und den im Katalog verwendeten Algorithmus.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.