Improve documentation and functionality for PnP PowerShell

[gautamdsheth]

Type

• Bug Fix
• New Feature
• Sample

Related Issues?

Fixes #NA

What is in this Pull Request ?

• Updated determinepermissions.md to improve clarity on permission requirements and logging.
• Revised docker.md to simplify version references and clarify usage instructions.
• Expanded environmentvariables.md with additional environment variable descriptions.
• Introduced logging.md to document the logging and tracing capabilities of PnP PowerShell.
• Added mcpserver.md to explain the integration of PnP PowerShell with AI assistants via the MCP server.
• Created nationalclouds.md to detail the handling of national and sovereign cloud environments.
• Enhanced registerapplication.md with specific instructions for GCC and national cloud setups.
• Added throttling.md to describe throttling behavior and retry mechanisms in PnP PowerShell.
• Updated toc.yml to include new articles on logging, throttling, national clouds, and MCP server.
• Removed obsolete images related to Azure Automation.
• Modified ConnectOnline.cs and PnPConnection.cs to support Azure AD Workload Identity and improve endpoint handling.
• Updated PnPOfficeManagementApiCmdlet.cs to dynamically set the Office Management API endpoint based on the connection.
• Marked the Force parameter in DisableFeature.cs as obsolete.
• Enhanced Endpoints.cs to return the correct Office 365 Management API endpoint based on the Azure environment.

[Copilot]

Copilot review overview

🟡 Changes recommended

The GCC endpoint, retry documentation, ineffective -WhatIf, and release-workflow safety issues must be corrected.

Review effort: Balanced
Findings: 6 · 1 · 7

Open (14)

• Pin stable release builds to the trusted main branch · New
• Pin ARM32 release checkout to main · New
• Pin ARM64 release checkout to main · New
• Pin AMD64 release checkout to main · New
• Honor ShouldProcess for WhatIf and Confirm · New
• Use the worldwide endpoint for GCC connections · New
• Complete release assets before publishing the module · New
• Limit sovereign endpoint changes to GCC High and DoD · New
• Document the correct GCC Office Management endpoint · New
• Fix the spelling of equivalent · New
• Clarify SharePointPnPHttpTimeout scope · New
• Correct the GCC endpoint mapping · New
• Correct retry behavior documentation for CSOM requests · New
• Clarify timeout settings do not affect CSOM requests · New

What changed in this PR

Improves sovereign-cloud connectivity, operational documentation, and release/container automation.

Changes:

• Adds cloud-aware authentication and Office Management API endpoints.
• Expands logging, throttling, MCP, cloud, and cmdlet documentation.
• Updates Docker and release workflows, including SBOM/provenance generation.

File	Description
src/​Commands/​Utilities/​Auth/​Endpoints.cs	Adds cloud-specific Management API endpoints.
src/​Commands/​Features/​DisableFeature.cs	Deprecates -Force.
src/​Commands/​Base/​PnPOfficeManagementApiCmdlet.cs	Uses connection-specific endpoints.
src/​Commands/​Base/​PnPConnection.cs	Preserves cloud and Graph endpoint state.
src/​Commands/​Base/​ConnectOnline.cs	Extends workload identity cloud options.
README.md	Links MCP server documentation.
pages/​articles/​toc.yml	Registers new articles.
pages/​articles/​throttling.md	Documents retry behavior.
pages/​articles/​registerapplication.md	Updates national-cloud registration guidance.
pages/​articles/​nationalclouds.md	Adds sovereign-cloud guidance.
pages/​articles/​mcpserver.md	Documents MCP integration.
pages/​articles/​logging.md	Adds tracing guidance.
pages/​articles/​environmentvariables.md	Documents additional settings.
pages/​articles/​docker.md	Refreshes image and architecture guidance.
pages/​articles/​determinepermissions.md	Replaces verbose guidance with tracing.
pages/​articles/​azurefunctions.md	Updates runtime and module guidance.
pages/​articles/​azureautomationrunbook.md	Updates runtime-environment setup.
pages/​articles/​authentication.md	Corrects national-cloud guidance.
documentation/​Write-PnPTraceLog.md	Corrects cmdlet syntax and metadata.
documentation/​Stop-PnPTraceLog.md	Clarifies parameter defaults.
documentation/​Move-PnPItemProxy.md	Adds cmdlet reference documentation.
documentation/​Get-PnPUnifiedAuditLog.md	Documents cloud endpoints.
documentation/​Get-PnPTraceLog.md	Clarifies log-stream availability.
documentation/​Disable-PnPFeature.md	Documents obsolete -Force.
documentation/​Connect-PnPOnline.md	Updates parameter-set documentation.
CHANGELOG.md	Records user-facing changes.
.github/​workflows/​stabledockerimages.yml	Reworks stable image publication.
.github/​workflows/​nightlydockerimages.yml	Passes the nightly ARM32 version.
.github/​workflows/​majorrelease.yml	Adds release assets and attestations.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.