Merge branch 'reference-doc-runcommandonset' of https://github.com/Gijsreyn/operation-methods into reference-doc-runcommandonset

Author: Gijsreyn

docs/reference/resources/Microsoft/DSC/PowerShell/index.md

@@ -86,7 +86,7 @@ set to `ClearCache`:
 $adapterScript = dsc resource list Microsoft.DSC/PowerShell |
     ConvertFrom-Json |
     Select-Object -ExpandProperty directory |
-    Join-Path
+    Join-Path -ChildPath 'psDscAdapter' -AdditionalChildPath 'powershell.resource.ps1'
 
 & $adapterScript -Operation ClearCache
 ```

docs/reference/resources/Microsoft/Windows/WindowsPowerShell/examples/manage-a-windows-service.md

@@ -1,6 +1,6 @@
 ---
 description: >
-    Examples showing how you can invoke the Microsoft.Windows/WindowsPowerShell with DSC to manage 
+    Examples showing how you can invoke the Microsoft.Windows/WindowsPowerShell with DSC to manage
     a Windows service using the PSDesiredStateConfiguration module.
 
 ms.date: 03/25/2025
@@ -54,7 +54,7 @@ When the resource configures the service, DSC returns the following result:
 
 ```yaml
 beforeState:
-  Status: null                                                                                                              /
+  Status: null
   Description: This service spools print jobs and handles interaction with the printer.  If you turn off this service, you won't be able to print or see your printers.
   DisplayName: Print Spooler
   ResourceId: null
@@ -109,7 +109,7 @@ dsc resource test --resource PSDesiredStateConfiguration/Service --input $instan
 
 ```yaml
 desiredState:
-  Name: Spooler                                                                                                             
+  Name: Spooler
   StartupType: Manual
 actualState:
   InDesiredState: true
@@ -135,7 +135,7 @@ When the resource stops the service, DSC returns the following result:
 
 ```yaml
 beforeState:
-  Status: null                                                                                                              
+  Status: null
   Description: This service spools print jobs and handles interaction with the printer.  If you turn off this service, you won't be able to print or see your printers.
   DisplayName: Print Spooler
   ResourceId: null
@@ -192,7 +192,7 @@ dsc resource get --resource PSDesiredStateConfiguration/Service --input $instanc
 
 ```yaml
 actualState:
-  Status: null                                                                                                              
+  Status: null
   Description: This service spools print jobs and handles interaction with the printer.  If you turn off this service, you won't be able to print or see your printers.
   DisplayName: Print Spooler
   ResourceId: null

docs/reference/resources/Microsoft/Windows/WindowsPowerShell/index.md

@@ -83,7 +83,7 @@ set to `ClearCache`:
 $adapterScript = dsc resource list Microsoft.Windows/WindowsPowerShell |
     ConvertFrom-Json |
     Select-Object -ExpandProperty directory |
-    Join-Path
+    Join-Path -ChildPath 'psDscAdapter\powershell.resource.ps1' 
 
 & $adapterScript -Operation ClearCache
 ```
@@ -131,7 +131,7 @@ To list the schema properties for a PowerShell DSC resource, you can run the fol
 
 ```powershell
 dsc resource list --adapter Microsoft.Windows/WindowsPowerShell <moduleName>/<resourceName> |
-    ConvertFrom-Json | 
+    ConvertFrom-Json |
     Select-Object properties
 ```
 
@@ -141,7 +141,7 @@ You can also retrieve more information by directly reading it from the cache fil
 $cache = Get-Content -Path "$env:LOCALAPPDATA\dsc\WindowsPSAdapterCache.json" |
     ConvertFrom-Json
 
-($cache.ResourceCache | Where-Object -Property type -EQ '<moduleName>/<resourceName>').DscResourceInfo.Properties
+($cache.ResourceCache | Where-Object -FilterScript { $_.type -eq '<moduleName>/<resourceName>' }).DscResourceInfo.Properties
 ```
 
 When defining a configuration document, the following properties are required.

dscecho/echo.dsc.resource.json

@@ -2,6 +2,7 @@
     "$schema": "https://aka.ms/dsc/schemas/v3/bundled/resource/manifest.json",
     "type": "Microsoft.DSC.Debug/Echo",
     "version": "1.0.0",
+    "description": "Echo resource for testing and debugging purposes",
     "get": {
         "executable": "dscecho",
         "args": [

sshdconfig/sshdconfig.dsc.resource.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://aka.ms/dsc/schemas/v3/bundled/resource/manifest.json",
-    "type": "Microsoft.Windows.OpenSSH.SSHD/sshd_config",
+    "type": "Microsoft.OpenSSH.SSHD/sshd_config",
     "description": "Manage SSH Server Configuration",
     "version": "0.1.0",
     "export": {