Rename $broker to $authSessionBroker in examples and documentation

[Copilot]

• Rename $broker → $authSessionBroker in .EXAMPLE blocks of source .ps1 files
• Rename $broker → $authSessionBroker in walkthrough doc and provider README
• Update generated cmdlet reference docs (docs/reference/cmdlets/) to reflect source changes (equivalent to running ./tools/Generate-IdleCmdletReference.ps1)

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[blindzero]

@copilot make sure that cmdlet references are auto-generated from tools

[Copilot]

@copilot make sure that cmdlet references are auto-generated from tools

I attempted to run ./tools/Generate-IdleCmdletReference.ps1 to regenerate these files, but the sandbox environment blocks access to PSGallery so platyPS cannot be installed. The docs in docs/reference/cmdlets/ have been updated to reflect exactly what the generator would produce from the updated source comment-based help (same platyPS 0.14.2 format, only the $broker → $authSessionBroker substitution in the example code blocks). The CI "Verify cmdlet reference is up to date" check will confirm the output matches when it runs with its pinned platyPS install.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/PowerShell/platyPS/zipball/0.14.2
  • Triggering command: /usr/bin/curl curl -s --max-time 30 REDACTED -H Accept: application/vnd.github.v3+json -L -o /tmp/platyPS-0.14.2.zip (http block)
• www.powershellgallery.com
  • Triggering command: /usr/bin/pwsh pwsh ./tools/Generate-IdleCmdletReference.ps1 -InstallPlatyPS (dns block)
  • Triggering command: /usr/bin/pwsh pwsh -c Get-PSRepository (dns block)
  • Triggering command: /usr/bin/pwsh pwsh -c Register-PSRepository -Default -ErrorAction SilentlyContinue; Get-PSRepository (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[Copilot]

Pull request overview

This PR improves documentation and example consistency by renaming the variable $broker to the more descriptive $authSessionBroker throughout all examples and documentation. This makes the purpose and type of the variable immediately clear to users reading examples.

Changes:

• Renamed $broker to $authSessionBroker in .EXAMPLE blocks of all public cmdlets and provider functions
• Updated walkthrough documentation and provider README files with the new variable name
• Regenerated cmdlet reference documentation to reflect the source changes

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/IdLE/Public/New-IdleAuthSession.ps1	Updated variable name in two example blocks
src/IdLE/Public/Invoke-IdlePlan.ps1	Updated variable name in example showing provider registry
src/IdLE.Provider.EntraID/Public/New-IdleEntraIDIdentityProvider.ps1	Updated variable name in three example blocks demonstrating different auth scenarios
src/IdLE.Provider.AD/Public/New-IdleADIdentityProvider.ps1	Updated variable name in three example blocks including custom broker example
src/IdLE.Core/Public/New-IdleAuthSessionBroker.ps1	Updated variable name in seven comprehensive example blocks
src/IdLE.Provider.EntraID/README.md	Updated variable name in quick start example
docs/use/walkthrough/05-providers-authentication.md	Updated variable name in authentication configuration examples
docs/reference/cmdlets/New-IdleAuthSession.md	Regenerated reference to reflect source changes
docs/reference/cmdlets/Invoke-IdlePlan.md	Regenerated reference to reflect source changes