Bagikan melalui


New-FileCatalog

Membuat file katalog Windows yang berisi hash kriptografi untuk file dan folder di jalur yang ditentukan.

Sintaks

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

Deskripsi

New-FileCatalogmembuat file katalog Windows untuk sekumpulan folder dan file. File katalog ini berisi hash untuk semua file di jalur yang disediakan. Pengguna kemudian dapat mendistribusikan katalog dengan file mereka sehingga pengguna dapat memvalidasi apakah ada perubahan yang telah dilakukan pada folder sejak waktu pembuatan katalog.

Katalog versi 1 dan 2 didukung. Versi 1 menggunakan algoritma hashing SHA1 (tidak digunakan lagi) untuk membuat hash file, dan versi 2 menggunakan SHA256.

Contoh

Contoh 1: Membuat katalog file untuk 'Microsoft.PowerShell.Utility'

$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

Parameter

-CatalogFilePath

Lokasi dan nama file katalog (.cat) yang Anda buat. Jika Anda hanya menentukan jalur folder, perintah akan membuat file bernama catalog.cat di lokasi tersebut.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CatalogVersion

1.0 Menerima atau 2.0 sebaik mungkin nilai untuk menentukan versi katalog. 1.0 harus dihindari jika memungkinkan karena menggunakan algoritma hash SHA-1 yang tidak aman. Versi 2.0 menggunakan algoritma SHA-256 yang aman.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menerima jalur atau array jalur ke file atau folder yang harus disertakan dalam file katalog. Jika folder ditentukan, perintah menyertakan semua file dalam folder.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Anda dapat menyalurkan string yang digunakan sebagai nama file katalog ke cmdlet ini.

Output

FileInfo

Cmdlet ini mengembalikan objek FileInfo yang mewakili katalog yang dibuat.