Update remarks

Author: Gijsreyn

docs/reference/resources/Microsoft/DSC/Transitional/RunCommandOnSet/examples/run-a-simple-command.md

@@ -14,16 +14,20 @@ execute a simple command during the **Set** operation.
 
 ## Test whether the command would run
 
-The following snippet shows how you can use the resource with the [dsc resource test][01] command to check whether the command would run.
+The following snippet shows how you can use the resource with the [dsc resource test][00] command to check whether
+the command would run.
 
 > [!NOTE]
 > The `dsc resource test` command performs a synthetic test on this resource. `Microsoft.DSC.Transitional/RunCommandOnSet` doesn't have
-> the `test` capability defined in the [resource manifest][02]
+> the `test` capability defined in the [resource manifest][01]
 
 ```powershell
 $instance = @{
-  executable = "echo"
-  arguments  = @("Configuration applied successfully")
+    executable = "C:\Windows\system32\cmd.exe"
+    arguments = @(
+        '/C',
+        'echo Hello world'
+    )
 } | ConvertTo-Json
 
 dsc resource test --resource Microsoft.DSC.Transitional/RunCommandOnSet --input $instance
@@ -34,30 +38,26 @@ When testing the resource, DSC returns a result indicating the desired state:
 ```yaml
 desiredState:
   arguments:
-  - Configuration applied successfully
-  executable: echo
+  - /C
+  - echo Hello world
+  executable: C:\Windows\system32\cmd.exe
 actualState:
-  executable: echo
+  executable: C:\Windows\system32\cmd.exe
   arguments:
-  - Configuration applied successfully
+  - /C
+  - echo Hello world
 inDesiredState: true
 differingProperties: []
 ```
 
-The `inDesiredState` field of the result object is set to `true`, indicating that the command would be executed during a **Set** operation.
+The `inDesiredState` field always returns `true` because of [pretest][02] is supported.
+This means the command is always executed during the **Set** operation.
 
 ## Run the command
 
 To execute the command, use the [dsc resource set][03] command.
 
 ```powershell
-$instance = @{
-    executable = "C:\Windows\system32\cmd.exe"
-    arguments = @(
-        '/C',
-        'echo Hello world'
-    )
-} | ConvertTo-Json
 dsc resource set --resource Microsoft.DSC.Transitional/RunCommandOnSet --input $instance
 ```
 
@@ -84,6 +84,7 @@ changedProperties: []
 > If you want to capture the output, you should redirect it to a file.
 
 <!-- Link reference definitions -->
-[01]: ../../../../../cli/resource/test.md
-[02]: ../../../../../../schemas/resource/manifest/test.md
+[00]: ../../../../../cli/resource/test.md
+[01]: ../../../../../../schemas/resource/manifest/test.md
+[02]: ../../../../../../../reference/cli/resource/set.md
 [03]: ../../../../../cli/resource/set.md

docs/reference/resources/Microsoft/DSC/Transitional/RunCommandOnSet/index.md

@@ -51,6 +51,11 @@ The resource allows you to:
 - Pass arguments to the executable
 - Define a custom exit code to indicate success
 
+> [!IMPORTANT]
+> The **Get** operation for this resource does not return any output from the executed command.
+> Additionally, when using the **Test** operation, the resource always reports as being
+> in the desired state.
+
 ## Capabilities
 
 The resource has the following capabilities:
@@ -64,10 +69,8 @@ the desired state. For more information about resource capabilities, see
 
 ## Examples
 
-1. [Run a simple command][01] - Shows how to create and delete registry keys with the
-   `dsc resource` commands.
-1. [Run a PowerShell command][02] - Shows how to create, modify, and delete registry values with the
-   `dsc resource` commands.
+1. [Run a simple command][01] - Shows how to run a simple command.
+1. [Run a PowerShell command][02] - Shows how you can run a PowerShell command.
 
 ## Properties