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 katalogu (cat) skrótami rzeczywistych plików na dysku. Jeśli wykryje jakiekolwiek niezgodności, 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 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. Tworzenie i weryfikowanie wykazu 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 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 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

Możesz potokować obiekt reprezentujący ścieżkę DirectoryInfo do plików, które muszą zostać zweryfikowane.

String

Możesz przekazać ciąg reprezentujący ścieżkę do plików, które muszą zostać zweryfikowane.

Dane wyjściowe

CatalogValidationStatus

Domyślnie to polecenie cmdlet zwraca obiekt CatalogValidationStatus z wartością Valid lub ValidationFailed.

CatalogInformation

Gdy 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 walidacji, które skróty były oczekiwane w porównaniu z znalezionym, oraz algorytmem używanym w wykazie.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.