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

Cmdlet ini hanya tersedia di platform Windows.

New-FileCatalog membuat 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.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-CatalogVersion

Menerima nilai 1.0 atau 2.0 mungkin 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.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:String[]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Catatan

Cmdlet ini hanya tersedia di platform Windows.