WindowsOptionalFeatures.adoc

DSC Resource 'WindowsOptionalFeatures'

WindowsOptionalFeatures installs Windows Optional Features on a Windows Client OS.

Source	https://github.com/dsccommunity/CommonTasks/tree/main/source/DSCResources/WindowsOptionalFeatures
DSC Resource	xPSDesiredStateConfiguration
Documentation	xWindowsOptionalFeature

Table 1. Attributes of category 'WindowsOptionalFeatures'

Parameter	Attribute	DataType	Description	Allowed Values
Names	Mandatory	string	Indicates the name of the feature that you want to ensure is added or removed. This is the same as the Name property from the Get-WindowsOptionalFeature cmdlet, and not the display name of the feature.	[+ | -]<name>
RemoveFilesOnDisable		Boolean	Set to true to remove all files associated with the features when Ensure is set to Absent.	True False (default)
NoWindowsUpdateCheck		Boolean	Specifies whether DISM contacts Windows Update (WU) when searching for the source files to enable a feature. If true, DISM does not contact WU.	True False (default)

Example

WindowsOptionalFeatures:
  RemoveFilesOnDisable: false
  NoWindowsUpdateCheck: false
  Names:
  - +TFTP
  - -TelnetClient
  - Hyper-V

Recommended Lookup Options in Datum.yml (Excerpt)

default_lookup_options: MostSpecific

lookup_options:

  WindowsOptionalFeatures:
    merge_hash: deep
  WindowsOptionalFeatures\Names:
    merge_basetype_array: Unique