New-FileCatalog
Membuat file katalog Windows yang berisi hash kriptografi untuk file dan folder di jalur yang ditentukan.
Sintaks
Default (Default)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet This 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 () yang Anda buat. Jika Anda hanya menentukan jalur folder, perintah akan membuat file bernama di lokasi tersebut.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-CatalogVersion
Menerima atau sebagai nilai yang mungkin untuk menentukan versi katalog. harus dihindari jika memungkinkan karena menggunakan algoritma hash SHA-1 yang tidak aman. Versi menggunakan algoritma SHA-256 yang aman.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menerima jalur atau daftar jalur ke berkas atau folder yang harus disertakan dalam berkas katalog. Saat Anda menentukan folder, perintah menghitung konten folder secara rekursif untuk menyertakan semua subfolder dan kontennya. File katalog berisi jalur relatif ke file yang disertakan dalam katalog.
Penting
Saat Anda menyediakan daftar file atau folder, cmdlet tidak dapat menghitung jalur relatif karena file dan folder dapat berada di mana saja di sistem file. Dalam kondisi ini, cmdlet hanya menggunakan nama file untuk hash, yang berarti Anda tidak dapat memiliki nama file duplikat di jalur yang berbeda. Untuk hasil terbaik, berikan satu folder dan biarkan cmdlet menghitung konten. Cmdlet menggunakan jalur awal tersebut untuk menghitung jalur relatif sehingga nama file duplikat masih unik di dalam pohon folder.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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.
