Test-FileCatalog
Test-FileCatalog
Sprawdza, czy skróty zawarte w pliku wykazu (cat) są zgodne z skrótami rzeczywistych plików w celu zweryfikowania ich autentyczności.
To polecenie cmdlet jest obsługiwane tylko w systemie Windows.
Składnia
Test-FileCatalog
[-Detailed]
[-FilesToSkip <String[]>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
Test-FileCatalog
Weryfikuje autentyczność plików, porównując skróty plików katalogu (cat) z skrótami rzeczywistych plików na dysku. Jeśli wykryje niezgodność, zwraca stan ValidationFailed. Użytkownicy mogą pobrać wszystkie te informacje przy użyciu parametru -Detailed. Wyświetla również stan podpisywania wykazu we właściwości Signature, która jest odpowiednikiem wywoływania polecenia Get-AuthenticodeSignature
cmdlet w pliku wykazu. Użytkownicy mogą również pominąć dowolny plik podczas walidacji przy użyciu parametru -FilesToSkip.
To polecenie cmdlet jest obsługiwane tylko w systemie Windows.
Przykłady
Przykład 1: Twórca i weryfikowanie katalogu plików
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
Przykład 2. Weryfikowanie katalogu plików przy użyciu szczegółowych danych wyjściowych
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
Parametry
-CatalogFilePath
Ścieżka do pliku wykazu (cat), który zawiera skróty, które mają być używane do weryfikacji.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Detailed
Zwraca więcej informacji bardziej szczegółowy CatalogInformation
obiekt, który zawiera pliki przetestowane, ich oczekiwane/rzeczywiste skróty i podpis Authenticode pliku wykazu, jeśli jest podpisany.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilesToSkip
Tablica ścieżek, które nie powinny być testowane w ramach walidacji.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Folder lub tablica plików, które powinny zostać zweryfikowane względem pliku wykazu.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
Można potokować DirectoryInfo
obiekt reprezentujący ścieżkę do plików, które należy zweryfikować.
Ciąg reprezentujący ścieżkę do plików, które muszą zostać zweryfikowane, można przekazać potok.
Dane wyjściowe
Domyślnie to polecenie cmdlet zwraca obiekt CatalogValidationStatus z wartością Valid
lub ValidationFailed
.
Jeśli używasz parametru Szczegółowe , polecenie cmdlet zwraca obiekt CatalogInformation dla każdego pliku, który może służyć do analizowania określonych plików, które mogą lub nie przeszły weryfikacji, które skróty były oczekiwane w porównaniu do znalezionych, oraz algorytm używany w wykazie.
Uwagi
To polecenie cmdlet jest dostępne tylko na platformach Windows.