Add Microsoft.Windows/FeatureOnDemandList resource

.vscode/settings.json

@@ -24,4 +24,4 @@
     ],
     "azure-pipelines.1ESPipelineTemplatesSchemaFile": true,
     "powershell.codeFormatting.preset": "OTBS"
-}
+}

resources/dism_dsc/.project.data.json

@@ -5,6 +5,6 @@
     "SupportedPlatformOS": "Windows",
     "Binaries": ["dism_dsc"],
     "CopyFiles": {
-        "Windows": ["optionalfeature.dsc.resource.json"]
+        "Windows": ["optionalfeature.dsc.resource.json", "featureondemand.dsc.resource.json"]
     }
 }

resources/dism_dsc/featureondemand.dsc.resource.json

@@ -0,0 +1,123 @@
+{
+    "$schema": "https://aka.ms/dsc/schemas/v3/bundled/resource/manifest.json",
+    "description": "Manage Windows Features on Demand (capabilities) using the DISM API.",
+    "tags": [
+        "windows",
+        "dism",
+        "capability",
+        "featureondemand",
+        "fod"
+    ],
+    "type": "Microsoft.Windows/FeatureOnDemandList",
+    "version": "0.1.0",
+    "get": {
+        "executable": "dism_dsc",
+        "args": [
+            "get",
+            "feature-on-demand"
+        ],
+        "input": "stdin",
+        "requireSecurityContext": "elevated"
+    },
+    "export": {
+        "executable": "dism_dsc",
+        "args": [
+            "export",
+            "feature-on-demand"
+        ],
+        "input": "stdin",
+        "requireSecurityContext": "elevated"
+    },
+    "set": {
+        "executable": "dism_dsc",
+        "args": [
+            "set",
+            "feature-on-demand"
+        ],
+        "input": "stdin",
+        "implementsPretest": false,
+        "return": "state",
+        "requireSecurityContext": "elevated"
+    },
+    "schema": {
+        "embedded": {
+            "$schema": "http://json-schema.org/draft-07/schema#",
+            "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/resources/Microsoft.Windows/FeatureOnDemandList/v0.1.0/schema.json",
+            "title": "Windows Feature on Demand",
+            "description": "Manage Windows Features on Demand (capabilities) using the DISM API. Supports get, set, and export operations.\n\nhttps://learn.microsoft.com/powershell/dsc/reference/microsoft.windows/featureondemandlist/resource\n",
+            "markdownDescription": "The `Microsoft.Windows/FeatureOnDemandList` resource enables you to manage Windows Features on Demand (capabilities) using the DISM API.\n\n[Online documentation][01]\n\n[01]: https://learn.microsoft.com/powershell/dsc/reference/microsoft.windows/featureondemandlist/resource\n",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "capabilities"
+            ],
+            "properties": {
+                "_restartRequired": {
+                    "type": "array",
+                    "title": "Restart required",
+                    "description": "Indicates that a system restart is required to complete the state change. Returned by the set operation when DISM reports that a reboot is needed.",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                    }
+                },
+                "capabilities": {
+                    "type": "array",
+                    "title": "Capabilities",
+                    "description": "An array of Feature on Demand (capability) filters or information objects.",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                            "identity": {
+                                "type": "string",
+                                "title": "Capability identity",
+                                "description": "The identity of the Windows capability (Feature on Demand). Required for get and set operations. For export operation, this is optional and wildcards (*) are supported for case-insensitive filtering."
+                            },
+                            "_exist": {
+                                "type": "boolean",
+                                "title": "Exists",
+                                "description": "Indicates whether the capability exists on the system. Set to false when the requested capability name is not recognized by DISM."
+                            },
+                            "state": {
+                                "type": "string",
+                                "enum": [
+                                    "NotPresent",
+                                    "UninstallPending",
+                                    "Staged",
+                                    "Removed",
+                                    "Installed",
+                                    "InstallPending",
+                                    "Superseded",
+                                    "PartiallyInstalled"
+                                ],
+                                "title": "Capability state",
+                                "description": "The current state of the capability. For set operations, this property is required and only Installed and NotPresent are accepted; other states are returned by get and export operations and are not valid inputs for set."
+                            },
+                            "displayName": {
+                                "type": "string",
+                                "title": "Display name",
+                                "description": "The display name of the capability. Returned by get and export operations. For export, wildcards (*) are supported for case-insensitive filtering."
+                            },
+                            "description": {
+                                "type": "string",
+                                "title": "Description",
+                                "description": "The description of the capability. Returned by get and export operations. For export, wildcards (*) are supported for case-insensitive filtering."
+                            },
+                            "downloadSize": {
+                                "type": "integer",
+                                "title": "Download size",
+                                "description": "The download size of the capability in bytes. Returned by get and export operations."
+                            },
+                            "installSize": {
+                                "type": "integer",
+                                "title": "Install size",
+                                "description": "The install size of the capability in bytes. Returned by get and export operations."
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

resources/dism_dsc/locales/en-us.toml

@@ -1,10 +1,11 @@
 _version = 1
 
 [main]
-missingOperation = "Missing operation argument"
-usage = "Usage: dism_dsc <get|set|export>"
+missingArguments = "Missing operation and resource type arguments"
+usage = "Usage: dism_dsc <get|set|export> <optional-feature|feature-on-demand>"
 windowsOnly = "This resource is only supported on Windows"
 unknownOperation = "Unknown operation '%{operation}'"
+unknownResourceType = "Unknown resource type '%{resource_type}'. Expected 'optional-feature' or 'feature-on-demand'"
 errorReadingInput = "Error reading input: %{err}"
 
 [get]
@@ -17,6 +18,25 @@ failedSerializeOutput = "Failed to serialize output: %{err}"
 failedParseInput = "Failed to parse input: %{err}"
 failedSerializeOutput = "Failed to serialize output: %{err}"
 
+[fod_get]
+failedParseInput = "Failed to parse input: %{err}"
+capabilitiesArrayEmpty = "Capabilities array cannot be empty for get operation"
+identityRequired = "identity is required for get operation"
+failedSerializeOutput = "Failed to serialize output: %{err}"
+
+[fod_export]
+failedParseInput = "Failed to parse input: %{err}"
+failedSerializeOutput = "Failed to serialize output: %{err}"
+
+[fod_set]
+failedParseInput = "Failed to parse input: %{err}"
+capabilitiesArrayEmpty = "Capabilities array cannot be empty for set operation"
+identityRequired = "identity is required for set operation"
+stateRequired = "state is required for set operation"
+capabilityNotFound = "Capability '%{identity}' was not found on this system"
+unsupportedDesiredState = "Unsupported desired state '%{state}'. Supported states for set are: Installed, NotPresent"
+failedSerializeOutput = "Failed to serialize output: %{err}"
+
 [set]
 failedParseInput = "Failed to parse input: %{err}"
 featuresArrayEmpty = "Features array cannot be empty for set operation"
@@ -34,3 +54,8 @@ getFeatureInfoFailed = "DismGetFeatureInfo failed for '%{name}': HRESULT %{hr}"
 enableFeatureFailed = "DismEnableFeature failed for '%{name}': HRESULT %{hr}"
 disableFeatureFailed = "DismDisableFeature failed for '%{name}': HRESULT %{hr}"
 getFeaturesFailed = "DismGetFeatures failed: HRESULT %{hr}"
+capabilitiesNotSupported = "Capability operations are not supported on this system. Capability APIs not available in dismapi.dll."
+getCapabilitiesFailed = "DismGetCapabilities failed: HRESULT %{hr}"
+getCapabilityInfoFailed = "DismGetCapabilityInfo failed for '%{name}': HRESULT %{hr}"
+addCapabilityFailed = "DismAddCapability failed for '%{name}': HRESULT %{hr}"
+removeCapabilityFailed = "DismRemoveCapability failed for '%{name}': HRESULT %{hr}"

resources/dism_dsc/optionalfeature.dsc.resource.json

@@ -12,15 +12,17 @@
     "get": {
         "executable": "dism_dsc",
         "args": [
-            "get"
+            "get",
+            "optional-feature"
         ],
         "input": "stdin",
         "requireSecurityContext": "elevated"
     },
     "set": {
         "executable": "dism_dsc",
         "args": [
-            "set"
+            "set",
+            "optional-feature"
         ],
         "input": "stdin",
         "implementsPretest": false,
@@ -30,7 +32,8 @@
     "export": {
         "executable": "dism_dsc",
         "args": [
-            "export"
+            "export",
+            "optional-feature"
         ],
         "input": "stdin",
         "requireSecurityContext": "elevated"