Skip to content

Fixes #12986 - Add note about limitation of ps1 files in CLM#12988

Merged
sdwheeler merged 1 commit into
MicrosoftDocs:mainfrom
sdwheeler:sdw-w575494-i12986-clm
May 4, 2026
Merged

Fixes #12986 - Add note about limitation of ps1 files in CLM#12988
sdwheeler merged 1 commit into
MicrosoftDocs:mainfrom
sdwheeler:sdw-w575494-i12986-clm

Conversation

@sdwheeler
Copy link
Copy Markdown
Collaborator

@sdwheeler sdwheeler commented May 4, 2026

PR Summary

Add note about limitation of ps1 files in CLM

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.
  • Contributor's Guide: I have read the contributor's guide.
  • Style: This PR adheres to the style guide.

Copilot AI review requested due to automatic review settings May 4, 2026 12:51
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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 updates the module manifest documentation to call out that .ps1-based entries in module manifests don’t work under Constrained Language mode (CLM), aligning the docs with the behavior reported in #12986.

Changes:

  • Add CLM limitation notes for .ps1 usage in module manifests (RootModule, ScriptsToProcess, NestedModules) across versioned about_Module_Manifests topics (5.1, 7.4–7.7).
  • Update the “How to write a PowerShell module manifest” article to point readers to about_Module_Manifests for element-by-element details (and remove the in-article “Module manifest elements” table).
  • Minor formatting/wording adjustments and ms.date updates.

Reviewed changes

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

Show a summary per file
File Description
reference/docs-conceptual/developer/module/how-to-write-a-powershell-module-manifest.md Removes the in-page manifest-elements table and redirects readers to about_Module_Manifests for detailed key documentation.
reference/7.7/Microsoft.PowerShell.Core/About/about_Module_Manifests.md Adds CLM notes for .ps1 usage in RootModule/ScriptsToProcess/NestedModules and tweaks related wording.
reference/7.6/Microsoft.PowerShell.Core/About/about_Module_Manifests.md Same CLM notes and wording adjustments as 7.7 for the 7.6 versioned topic.
reference/7.5/Microsoft.PowerShell.Core/About/about_Module_Manifests.md Same CLM notes and wording adjustments as 7.7 for the 7.5 versioned topic.
reference/7.4/Microsoft.PowerShell.Core/About/about_Module_Manifests.md Same CLM notes and wording adjustments as 7.7 for the 7.4 versioned topic.
reference/5.1/Microsoft.PowerShell.Core/About/about_Module_Manifests.md Adds the same CLM limitations for Windows PowerShell 5.1’s versioned topic.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +54 to +56
For more information, see the parameter descriptions in the [New-ModuleManifest][10] cmdlet. For
descriptions of the keys and values you can include in a module manifest, see
[about_Module_Manifests][04].
Comment on lines +949 to +951
> Modules specified as `.ps1` files aren't supported when the module is running
> in Constrained Language mode. The files listed can't run when the module is
> imported in that mode.
Comment on lines +949 to +951
> Modules specified as `.ps1` files aren't supported when the module is running
> in Constrained Language mode. The files listed can't run when the module is
> imported in that mode.
Comment on lines +949 to +951
> Modules specified as `.ps1` files aren't supported when the module is running
> in Constrained Language mode. The files listed can't run when the module is
> imported in that mode.
Comment on lines +949 to +951
> Modules specified as `.ps1` files aren't supported when the module is running
> in Constrained Language mode. The files listed can't run when the module is
> imported in that mode.
Comment on lines +948 to +950
> Modules specified as `.ps1` files aren't supported when the module is running
> in Constrained Language mode. The files listed can't run when the module is
> imported in that mode.
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 05bb1a1:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Core/About/about_Module_Manifests.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Core/About/about_Module_Manifests.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Core/About/about_Module_Manifests.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Core/About/about_Module_Manifests.md ✅Succeeded View (powershell-7.6)
reference/7.7/Microsoft.PowerShell.Core/About/about_Module_Manifests.md ✅Succeeded View (powershell-7.7)
reference/docs-conceptual/developer/module/how-to-write-a-powershell-module-manifest.md ✅Succeeded View (>=powershell-5.1)

For more details, please refer to the build report.

@sdwheeler sdwheeler merged commit 364305c into MicrosoftDocs:main May 4, 2026
11 checks passed
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.

In CLM .ps1 files don't work as RootModule, NestedModules, or ScriptsToProcess in Module Manifests

2 participants