Sumber Daya DSC WindowsFeature

Berlaku Untuk: Windows PowerShell 4.0, Windows PowerShell 5.x

Sumber daya WindowsFeature di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk memastikan bahwa peran dan fitur ditambahkan atau dihapus pada simpul target.

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

WindowsFeature [string] #ResourceName
{
    Name = [string]
    [ Credential = [PSCredential] ]
    [ IncludeAllSubFeature = [bool] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Properti

Properti	Deskripsi
Nama	Menunjukkan nama peran atau fitur yang ingin Anda pastikan ditambahkan atau dihapus. Ini sama dengan properti Nama dari cmdlet Get-WindowsFeature , dan bukan nama tampilan peran atau fitur.
Kredensial	Menunjukkan kredensial yang akan digunakan untuk menambahkan atau menghapus peran atau fitur.
SertakanAllSubFeature	Atur properti ini ke $true untuk memastikan status semua subfeature yang diperlukan dengan status fitur yang Anda tentukan dengan properti Nama .
LogPath	Menunjukkan 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

WindowsFeature RoleExample
{
    Ensure = "Present"
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature
}