Megosztás a következőn keresztül:

Test-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

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

Default (Alapértelmezett) 

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 az -Detailed paraméterrel lekérhetik ezeket az információkat. A katalógus aláírási állapotát is megjeleníti a Signature tulajdonságban, amely egyenértékű Get-AuthenticodeSignature katalógusfájl parancsmagjának meghívásával. A felhasználók az ellenőrzés során bármelyik fájlt kihagyhatják a -FilesToSkip paraméter használatával.

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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Detailed

További 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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FilesToSkip

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

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

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

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

DirectoryInfo

Az érvényesítendő fájlok elérési útját jelképező DirectoryInfo objektumot csövezheti.

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 Valid vagy ValidationFailedlehet.

CatalogInformation

Ha a Részletes paramétert használja, a parancsmag minden fájlhoz visszaad egy CatalogInformation objektumot, amely használható annak elemzésére, hogy a fájlok esetleg átmentek-e vagy sem az ellenőrzésen, milyen kivonatok voltak vártak és találtak, valamint a katalógusban használt algoritmus elemzésére.

Jegyzetek

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