New-FileCatalog

Modül:
Microsoft.PowerShell.Security Module

Belirtilen yollardaki dosyalar ve klasörler için şifreleme karmaları içeren bir Windows katalog dosyası oluşturur.

Syntax

Default (Varsayılan) 

New-FileCatalog
    [-CatalogVersion <Int32>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-FileCatalog, bir klasör ve dosya kümesi için bir Windows katalog dosyası oluşturur. Bu katalog dosyası, sağlanan yollardaki tüm dosyalar için karmalar içerir. Kullanıcılar daha sonra katalog oluşturma zamanından bu yana klasörlerde herhangi bir değişiklik yapılıp yapılmadığını doğrulayabilmesi için kataloğu dosyalarıyla dağıtabilir.

Katalog sürüm 1 ve 2 desteklenir. Sürüm 1, dosya karmaları oluşturmak için SHA1 karma algoritmasını (kullanım dışı) kullanır ve sürüm 2 SHA256'yı kullanır.

Önemli

SHA1 tabanlı kataloglar kullanım dışıdır ve güvenliğe duyarlı iş akışları için güvenilir olmamalıdır.

Örnekler

Örnek 1: 'Microsoft.PowerShell.Utility' için dosya kataloğu oluşturma

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

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

Parametreler

-CatalogFilePath

Oluşturduğunuz katalog dosyasının (.cat) konumu ve adı. Yalnızca bir klasör yolu belirtirseniz, komut bu konumda adlı catalog.cat bir dosya oluşturur.

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

-CatalogVersion

Katalog sürümünü belirtmek için veya olası değerleri kabul eder 1.02.0 . Sürüm 2.0 , güvenli SHA-256 algoritmasını kullanır.

Önemli

Sürüm 1.0 (SHA1 tabanlı) kataloglar kullanım dışıdır ve güvenlik açısından hassas iş akışları için güvenilir olmamalıdır.

Parametre özellikleri

Tür:Int32
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

-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

-Path

Katalog dosyasına eklenmesi gereken dosya veya klasörlerin yolunu veya yol dizisini kabul eder. Bir klasör belirttiğinizde, komut tüm alt klasörleri ve bunların içeriklerini içerecek şekilde klasörün içeriğini yinelemeli olarak numaralandırır. Katalog dosyası, kataloğa dahil edilen dosyaların göreli yollarını içerir.

Önemli

Dosya veya klasörlerin listesini sağladığınızda, dosya ve klasörler dosya sisteminde herhangi bir yerde olabileceğinden cmdlet göreli yolu hesaplayamaz. Bu koşul altında, cmdlet yalnızca karma için dosya adını kullanır; başka bir deyişle farklı yollarda yinelenen dosya adlarınız olamaz. En iyi sonuçlar için tek bir klasör geçirin ve cmdlet'in içeriği listelemesine izin verin. Cmdlet, göreli yolları hesaplamak için bu ilk yolu kullanır, böylece yinelenen dosya adları klasör ağacı içinde hala benzersiz olur.

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

String

Katalog dosya adı olarak kullanılan bir dizeyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

FileInfo

Bu cmdlet, oluşturulan kataloğu temsil eden bir FileInfo nesnesi döndürür.