Sumber Daya DSC WindowsFeatureSet
Berlaku Untuk: Windows PowerShell 5.x
Sumber daya WindowsFeatureSet di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk memastikan bahwa peran dan fitur ditambahkan atau dihapus pada simpul target. Sumber daya ini adalah sumber daya komposit yang memanggil sumber daya WindowsFeature untuk setiap fitur yang ditentukan dalam properti Nama .
Gunakan sumber daya ini ketika Anda ingin mengonfigurasi sejumlah Fitur Windows ke status yang sama.
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
WindowsFeatureSet [string] #ResourceName
{
Name = [string[]]
[ Source = [string] ]
[ IncludeAllSubFeature = [Boolean] ]
[ Credential = [PSCredential] ]
[ LogPath = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Properti
Properti | Deskripsi |
---|---|
Nama | Nama peran atau fitur yang ingin Anda pastikan ditambahkan atau dihapus. Ini sama dengan properti Nama cmdlet Get-WindowsFeature , dan bukan nama tampilan peran atau fitur. |
Sumber | Menunjukkan lokasi file sumber yang akan digunakan untuk penginstalan, jika perlu. |
SertakanAllSubFeature | Atur properti ini ke $true untuk menyertakan semua subfeature yang diperlukan dengan fitur yang Anda tentukan dengan properti Nama . |
Kredensial | Kredensial yang digunakan untuk menambahkan atau menghapus peran atau fitur. |
LogPath | Jalur ke file log tempat Anda ingin penyedia sumber daya mencatat operasi. |
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 | Menunjukkan apakah peran atau fitur ditambahkan. Untuk memastikan bahwa peran atau fitur ditambahkan, atur properti ini ke Sajikan. Untuk memastikan bahwa peran atau fitur dihapus, atur properti ke 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
Konfigurasi berikut memastikan bahwa fitur Web-Server (IIS) dan SMTP Server, dan semua subfeature masing-masing, diinstal.
configuration FeatureSetTest
{
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
WindowsFeatureSet WindowsFeatureSetExample
{
Name = @("SMTP-Server", "Web-Server")
Ensure = 'Present'
IncludeAllSubFeature = $true
}
}
}
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