Sumber Daya DSC WindowsOptionalFeature

Berlaku Untuk: Windows PowerShell 5.x

Sumber daya WindowsOptionalFeature di Windows PowerShell Desired State Configuration (DSC) menyediakan mekanisme untuk memastikan bahwa fitur opsional diaktifkan pada simpul target.

Catatan

WindowsOptionalFeature hanya berfungsi pada komputer klien Windows seperti Windows 10.

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

WindowsOptionalFeature [string] #ResourceName
{
    Name = [string]
    [ NoWindowsUpdateCheck = [bool] ]
    [ RemoveFilesOnDisable = [bool] ]
    [ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation }  ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Enable | Disable }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Properti

Properti	Deskripsi
Nama	Menunjukkan nama fitur yang ingin Anda pastikan diaktifkan atau dinonaktifkan.
NoWindowsUpdateCheck	Menentukan apakah kontak DISM Windows Update (WU) saat mencari file sumber untuk mengaktifkan fitur. Jika $true, DISM tidak menghubungi WU.
RemoveFilesOnDisable	Atur ke $true untuk menghapus semua file yang terkait dengan fitur saat Pastikan diatur ke Tidak Ada.
LogLevel	Tingkat output maksimum yang ditunjukkan dalam log. Nilai yang diterima adalah: ErrorsOnly, ErrorsAndWarning, dan ErrorsAndWarningAndInformation.
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	Menentukan apakah fitur diaktifkan. Untuk memastikan bahwa fitur diaktifkan, atur properti ini ke Aktifkan. Untuk memastikan bahwa fitur dinonaktifkan, atur properti ke Nonaktifkan. Nilai defaultnya adalah Aktifkan.
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.