Sumber Daya Arsip DSC
Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x
Sumber daya Arsip di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk membuka file arsip (.zip) di jalur tertentu.
Catatan
Dokumentasi sumber daya DSC ini mencakup versi yang disertakan dengan PowerShell sebelum versi 7.2. Modul PSDscResources berisi Sumber Daya DSC baru dan yang diperbarui yang secara resmi didukung oleh Microsoft. Modul PSDscResources tersedia dari Galeri PowerShell.
Untuk informasi selengkapnya dan dokumentasi yang diperbarui, lihat dokumentasi referensi PSDscResources.
Sintaks
Archive [string] #ResourceName
{
Destination = [string]
Path = [string]
[ Checksum = [string] { CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 } ]
[ Credential = [PSCredential] ]
[ Force = [bool] ]
[ Validate = [bool] ]
[ Ensure = [string] { Absent | Present } ]
[ DependsOn = [string[]] ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Properti
Properti | Deskripsi |
---|---|
Tujuan | Menentukan lokasi tempat Anda ingin memastikan konten arsip diekstrak. |
Jalur | Menentukan jalur sumber file arsip. |
Checksum | Menentukan jenis yang akan digunakan saat menentukan apakah dua file sama. Jika Checksum tidak ditentukan, hanya nama file atau direktori yang digunakan untuk perbandingan. Nilai yang valid meliputi: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Jika Anda menentukan Checksum tanpa Validasi, konfigurasi akan gagal. |
Kredensial | Kredensial akun pengguna dengan izin untuk mengakses jalur arsip dan tujuan yang ditentukan jika diperlukan. |
Force | Operasi file tertentu (seperti menimpa file atau menghapus direktori yang tidak kosong) akan mengakibatkan kesalahan. Menggunakan properti Force mengambil alih kesalahan tersebut. Nilai defaultnya adalah False. |
Memvalidasi | Menggunakan properti Checksum untuk menentukan apakah arsip cocok dengan tanda tangan. Jika Anda menentukan Checksum tanpa Validasi, konfigurasi akan gagal. Jika Anda menentukan Validasi tanpa Checksum, ChecksumSHA-256 digunakan secara default. |
Properti umum
Properti | Deskripsi |
---|---|
DependsOn | Menunjukkan bahwa konfigurasi sumber daya lain harus berjalan sebelum sumber daya ini dikonfigurasi. Misalnya, jika ID blok skrip konfigurasi sumber daya yang ingin Anda jalankan terlebih dahulu adalah ResourceName dan jenisnya adalah ResourceType, sintaks untuk menggunakan properti ini adalah DependsOn = "[ResourceType]ResourceName" . |
Pastikan | Menentukan apakah akan memeriksa apakah konten arsip ada di Tujuan. Atur properti ini ke Sajikan untuk memastikan isinya ada. Atur ke Absen untuk memastikan tidak ada. Nilai defaultnya adalah Ada. |
PsDscRunAsCredential | Mengatur kredensial untuk menjalankan seluruh sumber daya sebagai. |
Catatan
Properti umum PsDscRunAsCredential ditambahkan dalam WMF 5.0 untuk memungkinkan menjalankan sumber daya DSC apa pun dalam konteks info masuk lainnya. Untuk informasi selengkapnya, lihat Menggunakan Kredensial dengan Sumber Daya DSC.
Contoh
Contoh berikut menunjukkan cara menggunakan sumber daya Arsip untuk memastikan bahwa konten file arsip yang disebut Test.zip
ada dan diekstraksi di tujuan tertentu menggunakan dan diotorisasi.
Archive ArchiveExample {
Ensure = "Present"
Path = "C:\Users\Public\Documents\Test.zip"
Destination = "C:\Users\Public\Documents\ExtractionPath"
}
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk