Test-FileCatalog

  • Referencia
Modul:
Microsoft.PowerShell.Security

Test-FileCatalog Ellenőrzi, hogy a katalógusfájlban (.cat) található kivonatok megegyeznek-e a tényleges fájlok kivonatával a hitelességük ellenőrzése érdekében.

Ez a parancsmag csak Windows rendszeren támogatott.

Syntax

Test-FileCatalog
    [-Detailed]
    [-FilesToSkip <String[]>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

Test-FileCatalog A katalógusfájl (.cat) fájlkivonatainak és a lemezen lévő tényleges fájlok kivonatainak összehasonlításával ellenőrzi a fájlok hitelességét. Ha bármilyen eltérést észlel, az ValidationFailed állapotot adja vissza. A felhasználók ezeket az információkat a -Detailed paraméterrel kérdezhetik le. A katalógus aláírási állapotát is megjeleníti a Signature tulajdonságban, amely egyenértékű a katalógusfájl parancsmagjának meghívásával Get-AuthenticodeSignature . A felhasználók az ellenőrzés során bármelyik fájlt kihagyhatják a -FilesToSkip paraméterrel.

Ez a parancsmag csak Windows rendszeren támogatott.

Példák

1. példa: Fájlkatalógus létrehozása és ellenőrzése

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

2. példa: Fájlkatalógus ellenőrzése részletes kimenettel

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

Paraméterek

-CatalogFilePath

Az érvényesítéshez használandó kivonatokat tartalmazó katalógusfájl (.cat) elérési útja.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Több információt ad vissza egy részletesebb CatalogInformation objektumot, amely tartalmazza a tesztelt fájlokat, a várt/tényleges kivonatokat, valamint aláírás esetén a katalógusfájl hitelesítő aláírását.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilesToSkip

Olyan elérési utak tömbje, amelyeket nem szabad tesztelni az ellenőrzés részeként.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

A katalógusfájlon érvényesítendő fájlok mappája vagy tömbje.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

DirectoryInfo

Az érvényesítendő fájlok elérési útját jelző objektumot is becsúszthatja DirectoryInfo .

String

Az érvényesítendő fájlok elérési útját jelző sztringet is beszúrhat.

Kimenetek

CatalogValidationStatus

Ez a parancsmag alapértelmezés szerint egy CatalogValidationStatus objektumot ad vissza, amelynek értéke vagy ValidationFailed.Valid

CatalogInformation

A Részletes paraméter használatakor a parancsmag minden fájlhoz egy CatalogInformation objektumot ad vissza, amely olyan fájlok elemzésére használható, amelyek esetleg átmentek az ellenőrzésen, és amelyek a várt és a talált kivonatok, valamint a katalógusban használt algoritmus alapján elemezhetők.

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.