Udostępnij za pośrednictwem

Test-FileCatalog

  • Odwołanie
Moduł:
Microsoft.PowerShell.Security

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 z plikiem wykazu (cat) 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 równoważna wywołaniu Get-AuthenticodeSignature polecenia 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 wykazu 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 walidacji.

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 przetestowane pliki, 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

DirectoryInfo[], System.String[]

Potok akceptuje tablicę ciągów lub DirectoryInfo obiektów reprezentujących ścieżki do plików, które muszą zostać zweryfikowane.

Dane wyjściowe

CatalogValidationStatus

Domyślny typ zwracany zawierający wartość lub ValidValidationFailed.

CatalogInformation

Bardziej szczegółowy obiekt zwracany podczas używania -Detailed , którego można użyć do analizowania określonych plików, które mogą lub nie przeszły walidacji, które skróty były oczekiwane a znaleziono, oraz algorytm używany w wykazie.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.