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 állapotot a következőként ValidationFailedadja vissza: . A felhasználók a paraméterrel lekérhetik ezeket az -Detailed információkat. 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éter használatával.

Important

Az 1.0-s (SHA1-alapú) katalógusok elavultak, és nem megbízhatók a biztonsági szempontból érzékeny munkafolyamatokhoz.

Ez a parancsmag csak Windows rendszeren támogatott.

Példák

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

$NewFileCatalogParams = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    CatalogVersion = 2.0
}
New-FileCatalog @NewFileCatalogParams

$TestFileCatalogParams = @{
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

Valid

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

$TestFileCatalogParams = @{
    Detailed = $true
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

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

Egy katalógusfájl (.cat) elérési útja, amely tartalmazza az érvényesítéshez használandó kivonatokat.

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.

Kapcsolódó hivatkozások

• Új-Fájlkatalógus
• PowerShellGet