PowerShell · JamesWTruher · May 30, 2022 · May 30, 2022 · bergmeister · May 30, 2022
diff --git a/Engine/Engine.csproj b/Engine/Engine.csproj
@@ -1,10 +1,10 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <VersionPrefix>1.20.0</VersionPrefix>
+    <VersionPrefix>1.21.0</VersionPrefix>
     <TargetFrameworks>netcoreapp3.1;net452</TargetFrameworks>
     <AssemblyName>Microsoft.Windows.PowerShell.ScriptAnalyzer</AssemblyName>
-    <AssemblyVersion>1.20.0</AssemblyVersion>
+    <AssemblyVersion>1.21.0</AssemblyVersion>
     <PackageId>Engine</PackageId>
     <RootNamespace>Microsoft.Windows.PowerShell.ScriptAnalyzer</RootNamespace> <!-- Namespace needs to match Assembly name for ressource binding -->
     <LangVersion>9.0</LangVersion>

diff --git a/Engine/PSScriptAnalyzer.psd1 b/Engine/PSScriptAnalyzer.psd1
@@ -11,7 +11,7 @@ Author = 'Microsoft Corporation'
 RootModule = 'PSScriptAnalyzer.psm1'
 
 # Version number of this module.
-ModuleVersion = '1.20.0'
+ModuleVersion = '1.21.0'
 
 # ID used to uniquely identify this module
 GUID = 'd6245802-193d-4068-a631-8863a4342a18'

diff --git a/...or/Microsoft.PowerShell.CrossCompatibility/Microsoft.PowerShell.CrossCompatibility.csproj b/...or/Microsoft.PowerShell.CrossCompatibility/Microsoft.PowerShell.CrossCompatibility.csproj
@@ -1,9 +1,9 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <VersionPrefix>1.20.0</VersionPrefix>
+    <VersionPrefix>1.21.0</VersionPrefix>
     <TargetFrameworks>netstandard2.0;net452</TargetFrameworks>
-    <AssemblyVersion>1.20.0</AssemblyVersion>
+    <AssemblyVersion>1.21.0</AssemblyVersion>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">

diff --git a/Rules/Rules.csproj b/Rules/Rules.csproj
@@ -1,10 +1,10 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <VersionPrefix>1.20.0</VersionPrefix>
+    <VersionPrefix>1.21.0</VersionPrefix>
     <TargetFrameworks>netcoreapp3.1;net452</TargetFrameworks>
     <AssemblyName>Microsoft.Windows.PowerShell.ScriptAnalyzer.BuiltinRules</AssemblyName>
-    <AssemblyVersion>1.20.0</AssemblyVersion>
+    <AssemblyVersion>1.21.0</AssemblyVersion>
     <PackageId>Rules</PackageId>
     <RootNamespace>Microsoft.Windows.PowerShell.ScriptAnalyzer</RootNamespace> <!-- Namespace needs to match Assembly name for ressource binding -->
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <!-- Needed in order for Pluralize.NET DLL to appear in bin folder - https://github.com/NuGet/Home/issues/4488 -->

diff --git a/docs/Cmdlets/Get-ScriptAnalyzerRule.md b/docs/Cmdlets/Get-ScriptAnalyzerRule.md
@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.Windows.PowerShell.ScriptAnalyzer.dll-Help.xml
 Module Name: PSScriptAnalyzer
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/07/2021
 online version: https://docs.microsoft.com/powershell/module/psscriptanalyzer/get-scriptanalyzerrule?view=ps-modules&wt.mc_id=ps-gethelp
 schema: 2.0.0

diff --git a/docs/Cmdlets/Invoke-Formatter.md b/docs/Cmdlets/Invoke-Formatter.md
@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.Windows.PowerShell.ScriptAnalyzer.dll-Help.xml
 Module Name: PSScriptAnalyzer
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/07/2021
 online version: https://docs.microsoft.com/powershell/module/psscriptanalyzer/invoke-formatter?view=ps-modules&wt.mc_id=ps-gethelp
 schema: 2.0.0

diff --git a/docs/Cmdlets/Invoke-ScriptAnalyzer.md b/docs/Cmdlets/Invoke-ScriptAnalyzer.md
@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.Windows.PowerShell.ScriptAnalyzer.dll-Help.xml
 Module Name: PSScriptAnalyzer
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/07/2021
 online version: https://docs.microsoft.com/powershell/module/psscriptanalyzer/invoke-scriptanalyzer?view=ps-modules&wt.mc_id=ps-gethelp
 schema: 2.0.0

diff --git a/docs/Cmdlets/PSScriptAnalyzer.md b/docs/Cmdlets/PSScriptAnalyzer.md
@@ -1,10 +1,10 @@
 ---
 Download Help Link: https://aka.ms/ps-modules-help
-Help Version: 1.20.0
+Help Version: 1.21.0
 Locale: en-US
 Module Guid: d6245802-193d-4068-a631-8863a4342a18
 Module Name: PSScriptAnalyzer
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/07/2021
 ---
 

diff --git a/docs/Rules/AlignAssignmentStatement.md b/docs/Rules/AlignAssignmentStatement.md
@@ -1,6 +1,6 @@
 ---
 description: Align assignment statement
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AlignAssignmentStatement

diff --git a/docs/Rules/AvoidAssignmentToAutomaticVariable.md b/docs/Rules/AvoidAssignmentToAutomaticVariable.md
@@ -1,6 +1,6 @@
 ---
 description: Changing automatic variables might have undesired side effects
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidAssignmentToAutomaticVariable

diff --git a/docs/Rules/AvoidDefaultValueForMandatoryParameter.md b/docs/Rules/AvoidDefaultValueForMandatoryParameter.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Default Value For Mandatory Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidDefaultValueForMandatoryParameter

diff --git a/docs/Rules/AvoidDefaultValueSwitchParameter.md b/docs/Rules/AvoidDefaultValueSwitchParameter.md
@@ -1,6 +1,6 @@
 ---
 description: Switch Parameters Should Not Default To True
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidDefaultValueSwitchParameter

diff --git a/docs/Rules/AvoidGlobalAliases.md b/docs/Rules/AvoidGlobalAliases.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid global aliases.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalAliases

diff --git a/docs/Rules/AvoidGlobalFunctions.md b/docs/Rules/AvoidGlobalFunctions.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid global functions and aliases
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalFunctions

diff --git a/docs/Rules/AvoidGlobalVars.md b/docs/Rules/AvoidGlobalVars.md
@@ -1,6 +1,6 @@
 ---
 description: No Global Variables
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalVars

diff --git a/docs/Rules/AvoidInvokingEmptyMembers.md b/docs/Rules/AvoidInvokingEmptyMembers.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Invoking Empty Members
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidInvokingEmptyMembers

diff --git a/docs/Rules/AvoidLongLines.md b/docs/Rules/AvoidLongLines.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid long lines
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidLongLines

diff --git a/docs/Rules/AvoidMultipleTypeAttributes.md b/docs/Rules/AvoidMultipleTypeAttributes.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid multiple type specifiers on parameters.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidMultipleTypeAttributes

diff --git a/docs/Rules/AvoidNullOrEmptyHelpMessageAttribute.md b/docs/Rules/AvoidNullOrEmptyHelpMessageAttribute.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid using null or empty HelpMessage parameter attribute.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidNullOrEmptyHelpMessageAttribute

diff --git a/docs/Rules/AvoidOverwritingBuiltInCmdlets.md b/docs/Rules/AvoidOverwritingBuiltInCmdlets.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid overwriting built in cmdlets
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidOverwritingBuiltInCmdlets

diff --git a/docs/Rules/AvoidShouldContinueWithoutForce.md b/docs/Rules/AvoidShouldContinueWithoutForce.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using ShouldContinue Without Boolean Force Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidShouldContinueWithoutForce

diff --git a/docs/Rules/AvoidTrailingWhitespace.md b/docs/Rules/AvoidTrailingWhitespace.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid trailing whitespace
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidTrailingWhitespace

diff --git a/docs/Rules/AvoidUsingCmdletAliases.md b/docs/Rules/AvoidUsingCmdletAliases.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Cmdlet Aliases or omitting the 'Get-' prefix.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingCmdletAliases

diff --git a/docs/Rules/AvoidUsingComputerNameHardcoded.md b/docs/Rules/AvoidUsingComputerNameHardcoded.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using ComputerName Hardcoded
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingComputerNameHardcoded

diff --git a/docs/Rules/AvoidUsingConvertToSecureStringWithPlainText.md b/docs/Rules/AvoidUsingConvertToSecureStringWithPlainText.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using SecureString With Plain Text
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingConvertToSecureStringWithPlainText

diff --git a/docs/Rules/AvoidUsingDeprecatedManifestFields.md b/docs/Rules/AvoidUsingDeprecatedManifestFields.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Deprecated Manifest Fields
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingDeprecatedManifestFields

diff --git a/docs/Rules/AvoidUsingDoubleQuotesForConstantString.md b/docs/Rules/AvoidUsingDoubleQuotesForConstantString.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid using double quotes if the string is constant.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingDoubleQuotesForConstantString

diff --git a/docs/Rules/AvoidUsingEmptyCatchBlock.md b/docs/Rules/AvoidUsingEmptyCatchBlock.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Empty Catch Block
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingEmptyCatchBlock

diff --git a/docs/Rules/AvoidUsingInvokeExpression.md b/docs/Rules/AvoidUsingInvokeExpression.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Invoke-Expression
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingInvokeExpression

diff --git a/docs/Rules/AvoidUsingPlainTextForPassword.md b/docs/Rules/AvoidUsingPlainTextForPassword.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Plain Text For Password Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingPlainTextForPassword

diff --git a/docs/Rules/AvoidUsingPositionalParameters.md b/docs/Rules/AvoidUsingPositionalParameters.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Positional Parameters
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingPositionalParameters

diff --git a/docs/Rules/AvoidUsingUsernameAndPasswordParams.md b/docs/Rules/AvoidUsingUsernameAndPasswordParams.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Username and Password Parameters
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingUsernameAndPasswordParams

diff --git a/docs/Rules/AvoidUsingWMICmdlet.md b/docs/Rules/AvoidUsingWMICmdlet.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Get-WMIObject, Remove-WMIObject, Invoke-WmiMethod, Register-WmiEvent, Set-WmiInstance
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingWMICmdlet

diff --git a/docs/Rules/AvoidUsingWriteHost.md b/docs/Rules/AvoidUsingWriteHost.md
@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Write-Host
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingWriteHost

diff --git a/docs/Rules/DSCDscExamplesPresent.md b/docs/Rules/DSCDscExamplesPresent.md
@@ -1,6 +1,6 @@
 ---
 description: DSC examples are present
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCDscExamplesPresent

diff --git a/docs/Rules/DSCDscTestsPresent.md b/docs/Rules/DSCDscTestsPresent.md
@@ -1,6 +1,6 @@
 ---
 description: Dsc tests are present
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCDscTestsPresent

diff --git a/docs/Rules/DSCReturnCorrectTypesForDSCFunctions.md b/docs/Rules/DSCReturnCorrectTypesForDSCFunctions.md
@@ -1,6 +1,6 @@
 ---
 description: Return Correct Types For DSC Functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCReturnCorrectTypesForDSCFunctions

diff --git a/docs/Rules/DSCStandardDSCFunctionsInResource.md b/docs/Rules/DSCStandardDSCFunctionsInResource.md
@@ -1,6 +1,6 @@
 ---
 description: Use Standard Get/Set/Test TargetResource functions in DSC Resource
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCStandardDSCFunctionsInResource

diff --git a/docs/Rules/DSCUseIdenticalMandatoryParametersForDSC.md b/docs/Rules/DSCUseIdenticalMandatoryParametersForDSC.md
@@ -1,6 +1,6 @@
 ---
 description: Use identical mandatory parameters for DSC Get/Test/Set TargetResource functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseIdenticalMandatoryParametersForDSC

diff --git a/docs/Rules/DSCUseIdenticalParametersForDSC.md b/docs/Rules/DSCUseIdenticalParametersForDSC.md
@@ -1,6 +1,6 @@
 ---
 description: Use Identical Parameters For DSC Test and Set Functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseIdenticalParametersForDSC

diff --git a/docs/Rules/DSCUseVerboseMessageInDSCResource.md b/docs/Rules/DSCUseVerboseMessageInDSCResource.md
@@ -1,6 +1,6 @@
 ---
 description: Use verbose message in DSC resource
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseVerboseMessageInDSCResource

diff --git a/docs/Rules/MisleadingBacktick.md b/docs/Rules/MisleadingBacktick.md
@@ -1,6 +1,6 @@
 ---
 description: Misleading Backtick
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: MisleadingBacktick

diff --git a/docs/Rules/MissingModuleManifestField.md b/docs/Rules/MissingModuleManifestField.md
@@ -1,6 +1,6 @@
 ---
 description: Module Manifest Fields
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: MissingModuleManifestField

diff --git a/docs/Rules/PlaceCloseBrace.md b/docs/Rules/PlaceCloseBrace.md
@@ -1,6 +1,6 @@
 ---
 description: Place close braces
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PlaceCloseBrace

diff --git a/docs/Rules/PlaceOpenBrace.md b/docs/Rules/PlaceOpenBrace.md
@@ -1,6 +1,6 @@
 ---
 description: Place open braces consistently
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PlaceOpenBrace

diff --git a/docs/Rules/PossibleIncorrectComparisonWithNull.md b/docs/Rules/PossibleIncorrectComparisonWithNull.md
@@ -1,6 +1,6 @@
 ---
 description: Null Comparison
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PossibleIncorrectComparisonWithNull

diff --git a/docs/Rules/PossibleIncorrectUsageOfAssignmentOperator.md b/docs/Rules/PossibleIncorrectUsageOfAssignmentOperator.md
@@ -1,6 +1,6 @@
 ---
 description: Equal sign is not an assignment operator. Did you mean the equality operator \'-eq\'?
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PossibleIncorrectUsageOfAssignmentOperator