Skip to content

docs: Update PSScript examples#1528

Open
Gijsreyn wants to merge 2 commits into
PowerShell:mainfrom
Gijsreyn:update-ps-examples
Open

docs: Update PSScript examples#1528
Gijsreyn wants to merge 2 commits into
PowerShell:mainfrom
Gijsreyn:update-ps-examples

Conversation

@Gijsreyn
Copy link
Copy Markdown
Collaborator

PR Summary

This pull request updates the already scaffolded examples for Microsoft.DSC.Transitional/WindowsPowerShell and Microsoft.DSC.Transitional/PowerShell.

Copilot AI review requested due to automatic review settings May 10, 2026 14:38
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 WindowsPowerShellScript example showing get/test/set patterns for Windows service state.
  • Add two new PowerShellScript examples 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.

@michaeltlombardi
Copy link
Copy Markdown
Collaborator

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!

@michaeltlombardi michaeltlombardi force-pushed the update-ps-examples branch 2 times, most recently from f23e8d4 to da95e53 Compare June 3, 2026 18:34
Gijsreyn and others added 2 commits June 8, 2026 10:28
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.
@michaeltlombardi
Copy link
Copy Markdown
Collaborator

Approved, pending final technical review - should only need to review one set of docs, as the content is largely mirrored across them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants