Aracılığıyla paylaş

Test-FileCatalog

Modül:
Microsoft.PowerShell.Security Module

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

Bu cmdlet yalnızca Windows'ta desteklenir.

Sözdizimi

Default EnterprisePublishing 

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Test-FileCatalog, bir katalog dosyasının (.cat) dosya karmalarını disk üzerindeki gerçek dosyaların karmalarıyla karşılaştırarak dosyaların orijinalliğini doğrular. Herhangi bir uyuşmazlık algılarsa, durumu ValidationFailed olarak döndürür. Kullanıcılar -Detailed parametresini kullanarak tüm bu bilgileri alabilir. Ayrıca signature özelliğinde kataloğun imzalama durumunu görüntüler. Bu durum, katalog dosyasındaki Get-AuthenticodeSignature cmdlet'ini çağırmaya eşdeğerdir. Kullanıcılar doğrulama sırasında -FilesToSkip parametresini kullanarak da herhangi bir dosyayı atlayabilir.

Bu cmdlet yalnızca Windows'ta desteklenir.

Örnekler

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

$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

Örnek 2: Ayrıntılı çıkışla dosya kataloğunu doğrulama

$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

Parametreler

-CatalogFilePath

Doğrulama amacıyla kullanılacak karmaları içeren bir katalog dosyasının yolunu (.cat) belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Detailed

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-FilesToSkip

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

Katalog dosyasında doğrulanması gereken bir klasör veya dosya dizisi.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

DirectoryInfo

Doğrulanması gereken dosyaların yolunu temsil eden bir DirectoryInfo nesnesine kanal oluşturabilirsiniz.

String

Yolu temsil eden bir dizeyi doğrulanması gereken dosyalara yöneltebilirsiniz.

Çıkışlar

CatalogValidationStatus

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

CatalogInformation

Ayrıntılı parametresini kullandığınızda, cmdlet her dosya için bir CatalogInformation nesnesi döndürür. Bu nesne, doğrulamayı geçmiş veya geçmemiş belirli dosyaları analiz etmek için kullanılabilir, hangi karmaların beklenip hangilerinin bulunduğunu ve doğrulama için katalogda kullanılan algoritmayı belirlemek için kullanılabilir.

Notlar

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