docs: Update PSScript examples - #1528
Conversation
There was a problem hiding this comment.
Pull request overview
This PR refreshes and expands the documentation examples for the transitional PowerShellScript and WindowsPowerShellScript DSC resources, aligning the resource reference pages with clearer, more complete sample scenarios.
Changes:
- Update resource index pages to point to the new/renamed example documents.
- Add a new
WindowsPowerShellScriptexample showing get/test/set patterns for Windows service state. - Add two new
PowerShellScriptexamples covering basic get/set/test behavior and input/output binding patterns.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/reference/resources/Microsoft/DSC/Transitional/WindowsPowerShellScript/index.md | Updates the “See also” example link to the new Windows service-state example page. |
| docs/reference/resources/Microsoft/DSC/Transitional/WindowsPowerShellScript/examples/manage-windows-service-state-with-powershell.md | New end-to-end example demonstrating inline Windows PowerShell scripts for service state management. |
| docs/reference/resources/Microsoft/DSC/Transitional/PowerShellScript/index.md | Updates the example link to the renamed “run a simple” example page. |
| docs/reference/resources/Microsoft/DSC/Transitional/PowerShellScript/examples/run-a-simple-powershell-script.md | New example illustrating basic get/set/test usage and stream/log-level mapping. |
| docs/reference/resources/Microsoft/DSC/Transitional/PowerShellScript/examples/powershell-script-with-input-output.md | New example illustrating input binding and error cases when input/param mismatch. |
|
Starting editorial pass, will be updating the commit directly and force pushing when completed. Please don't make any changes to this PR while I'm actively editing the documentation. Thank you! |
f23e8d4 to
da95e53
Compare
This change updates the reference docs for the `WindowsPowerShellScript` resource, including new examples and updates to the index page. It is largely a mirror of the `PowerShellScript` resource, as the resources share an implementation script.
da95e53 to
65b9a48
Compare
|
Approved, pending final technical review - should only need to review one set of docs, as the content is largely mirrored across them. |
|
Steve Lee (@SteveL-MSFT) - mind doing a technical review on this one? |
PR Summary
This pull request updates the already scaffolded examples for
Microsoft.DSC.Transitional/WindowsPowerShellandMicrosoft.DSC.Transitional/PowerShell.