From ad2c63e60be1bf0c3691e00c225739be17f2ccef Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 24 Sep 2025 14:09:23 -0500 Subject: [PATCH 1/4] Upcase H2 headers --- .../About/about_Comment_Based_Help.md | 6 +++++- .../About/about_Environment_Variables.md | 3 ++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md index 16cba68568d..d184b60a1aa 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md +++ b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md @@ -10,7 +10,6 @@ title: about_Comment_Based_Help # about_Comment_Based_Help ## SHORT DESCRIPTION - Describes how to write comment-based help content for functions and scripts. ## LONG DESCRIPTION @@ -36,6 +35,7 @@ information about how to display help content for functions and scripts, see The [Update-Help][08] and [Save-Help][07] cmdlets work only on XML files. Updatable Help doesn't support comment-based help content. +## SYNTAX FOR COMMENT-BASED HELP ## SYNTAX FOR COMMENT-BASED HELP To create Comment-based help content, you can use either style of comments: @@ -86,6 +86,7 @@ as `.EXAMPLE`, can appear many times in the same comment block. The help content for each keyword begins on the line after the keyword and can span multiple lines. +## SYNTAX FOR COMMENT-BASED HELP IN FUNCTIONS ## SYNTAX FOR COMMENT-BASED HELP IN FUNCTIONS Comment-based help for a function can appear in one of three locations: @@ -131,6 +132,7 @@ or function Get-Function { } ``` +## SYNTAX FOR COMMENT-BASED HELP IN SCRIPTS ## SYNTAX FOR COMMENT-BASED HELP IN SCRIPTS Comment-based help for a script can appear in one of the following two @@ -168,6 +170,7 @@ function Get-Function { } #> ``` +## COMMENT-BASED HELP KEYWORDS ## COMMENT-BASED HELP KEYWORDS The following are valid comment-based help keywords. These keywords can appear @@ -346,6 +349,7 @@ as it does in a module directory. For more information about the cmdlet help XML-based help file format, see [How to Write Cmdlet Help][01]. +## AUTOGENERATED CONTENT ## AUTOGENERATED CONTENT The name, syntax, parameter list, parameter attribute table, common parameters, diff --git a/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md b/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md index 34b7f7fd723..f94e01fd0a6 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md +++ b/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md @@ -9,7 +9,6 @@ title: about_Environment_Variables # about_Environment_Variables ## SHORT DESCRIPTION - Describes how to access and manage environment variables in PowerShell. ## LONG DESCRIPTION @@ -25,6 +24,8 @@ programs. PowerShell creates the following environment variables: For full descriptions of these variables, see the [PowerShell environment variables][03] of this article. +## LONG DESCRIPTION + PowerShell can access and manage environment variables in any of the supported operating system platforms. The PowerShell Environment provider lets you get, add, change, clear, and delete environment variables in the current console. From 54f3a2cd4ccc14e6bbb03d460168d09ba306dd26 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Wed, 24 Sep 2025 14:29:10 -0500 Subject: [PATCH 2/4] Fix structure of About files --- .../About/about_Comment_Based_Help.md | 1 + .../About/about_Environment_Variables.md | 3 +-- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md index d184b60a1aa..1d90e6a33f1 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md +++ b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md @@ -10,6 +10,7 @@ title: about_Comment_Based_Help # about_Comment_Based_Help ## SHORT DESCRIPTION + Describes how to write comment-based help content for functions and scripts. ## LONG DESCRIPTION diff --git a/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md b/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md index f94e01fd0a6..34b7f7fd723 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md +++ b/reference/5.1/Microsoft.PowerShell.Core/About/about_Environment_Variables.md @@ -9,6 +9,7 @@ title: about_Environment_Variables # about_Environment_Variables ## SHORT DESCRIPTION + Describes how to access and manage environment variables in PowerShell. ## LONG DESCRIPTION @@ -24,8 +25,6 @@ programs. PowerShell creates the following environment variables: For full descriptions of these variables, see the [PowerShell environment variables][03] of this article. -## LONG DESCRIPTION - PowerShell can access and manage environment variables in any of the supported operating system platforms. The PowerShell Environment provider lets you get, add, change, clear, and delete environment variables in the current console. From 4c45cebb4be7387e9723d9d0ecebc3d9fc5711b6 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Thu, 25 Sep 2025 08:34:52 -0500 Subject: [PATCH 3/4] Fix test script file names --- .../security/app-control/application-control.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/docs-conceptual/security/app-control/application-control.md b/reference/docs-conceptual/security/app-control/application-control.md index 0813dc588b6..333566b1ded 100644 --- a/reference/docs-conceptual/security/app-control/application-control.md +++ b/reference/docs-conceptual/security/app-control/application-control.md @@ -1,6 +1,6 @@ --- description: This article explains the features of Application Control that can be used to secure your PowerShell environment. -ms.date: 10/21/2024 +ms.date: 09/25/2025 title: Use App Control to secure PowerShell --- # Use App Control to secure PowerShell @@ -23,8 +23,8 @@ doesn't have way to query the policy enforcement status. To detect if a system w control policy is being enforced by AppLocker, PowerShell creates two temporary files and tests if they can be executed. The filenames use the following name format: -- `$Env:TEMP/__PSAppLockerTest__.ps1` -- `$Env:TEMP/__PSAppLockerTest__.psm1` +- `$Env:TEMP/__PSScriptPolicyTest_.ps1` +- `$Env:TEMP/__PSScriptPolicyTest_.psm1` App Control for Business is the preferred application control system for Windows. App Control provides APIs that allow you to discover the policy configuration. App Control is designed as a From a23f7a8c876c0d1991f0fdd8ed62f74231bce546 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Thu, 25 Sep 2025 08:41:22 -0500 Subject: [PATCH 4/4] remove doubled H2s --- .../About/about_Comment_Based_Help.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md index 1d90e6a33f1..16cba68568d 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md +++ b/reference/5.1/Microsoft.PowerShell.Core/About/about_Comment_Based_Help.md @@ -36,7 +36,6 @@ information about how to display help content for functions and scripts, see The [Update-Help][08] and [Save-Help][07] cmdlets work only on XML files. Updatable Help doesn't support comment-based help content. -## SYNTAX FOR COMMENT-BASED HELP ## SYNTAX FOR COMMENT-BASED HELP To create Comment-based help content, you can use either style of comments: @@ -87,7 +86,6 @@ as `.EXAMPLE`, can appear many times in the same comment block. The help content for each keyword begins on the line after the keyword and can span multiple lines. -## SYNTAX FOR COMMENT-BASED HELP IN FUNCTIONS ## SYNTAX FOR COMMENT-BASED HELP IN FUNCTIONS Comment-based help for a function can appear in one of three locations: @@ -133,7 +131,6 @@ or function Get-Function { } ``` -## SYNTAX FOR COMMENT-BASED HELP IN SCRIPTS ## SYNTAX FOR COMMENT-BASED HELP IN SCRIPTS Comment-based help for a script can appear in one of the following two @@ -171,7 +168,6 @@ function Get-Function { } #> ``` -## COMMENT-BASED HELP KEYWORDS ## COMMENT-BASED HELP KEYWORDS The following are valid comment-based help keywords. These keywords can appear @@ -350,7 +346,6 @@ as it does in a module directory. For more information about the cmdlet help XML-based help file format, see [How to Write Cmdlet Help][01]. -## AUTOGENERATED CONTENT ## AUTOGENERATED CONTENT The name, syntax, parameter list, parameter attribute table, common parameters,