Test Dosyası Kataloğu (Microsoft.PowerShell.Security)


Test-FileCatalog

Modül:
Microsoft.PowerShell.Security

Test-FileCatalog, orijinalliklerini doğrulamak için bir katalog dosyasında (.cat) bulunan karmaların gerçek dosyaların karmalarıyla eşleşip eşleşmediğini doğrular.

Bu cmdlet yalnızca Windows'ta desteklenir.

Sözdizimi

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

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Test-FileCatalog, bir katalog dosyasının (.cat) dosya karmalarını diskteki gerçek dosyaların karmalarıyla karşılaştırarak dosyaların orijinalliğini doğrular. Herhangi bir uyumsuzluk tespit ederse durumu ValidationFailed olarak döndürür. Kullanıcılar tüm bu bilgileri -Detailed parametresini kullanarak alabilirler. Ayrıca Signature özelliğinde kataloğun imzalama durumunu da görüntüler; bu, katalog dosyasında Get-AuthenticodeSignature cmdlet'ini çağırmaya eşdeğerdir. Kullanıcılar ayrıca doğrulama sırasında -FilesToSkip parametresini kullanarak herhangi bir dosyayı atlayabilir.

Bu cmdlet yalnızca Windows'ta desteklenir.

Örnekler

Örnek 1: Dosya kataloğu oluşturma ve doğrulama

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

Örnek 2: Ayrıntılı çıktıyla bir dosya kataloğunu doğrulama

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

Parametreler

-CatalogFilePath

Doğrulama için kullanılacak karmaları içeren katalog dosyasının (.cat) yolu.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Detailed

Daha fazla bilgi, test edilen dosyaları, bunların beklenen/gerçek karmalarını ve imzalanmışsa katalog dosyasının Authenticode imzasını içeren daha ayrıntılı bir CatalogInformation nesnesi döndürür.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-FilesToSkip

Doğrulamanın bir parçası olarak test edilmemesi gereken bir dizi yol.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Path

Katalog dosyasına göre doğrulanması gereken bir klasör veya dosya dizisi.

Tip :

String[]

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

DizinBilgisi

Doğrulanması gereken dosyaların yolunu temsil eden bir DirectoryInfo nesnesini yönlendirebilirsiniz.

Dize

Doğrulanması gereken dosyaların yolunu temsil eden bir dize yönlendirebilirsiniz.

Çıkışlar

KatalogDoğrulama Durumu

Varsayılan olarak bu cmdlet, Valid veya ValidationFailed değerine sahip bir CatalogValidationStatus nesnesi döndürür.

KatalogBilgileri

Detaylı parametresini kullandığınızda cmdlet, her dosya için doğrulamayı geçmiş veya geçmemiş belirli dosyaları analiz etmek için kullanılabilecek bir CatalogInformation nesnesi döndürür. beklenen ve bulunanlar ve katalogda kullanılan algoritma.

Notlar

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

İlgili makaleler