Allowing to skip tests with 'SuppressMessageAttribute' (#178)

* Allowing to skip tests with 'SuppressMessageAttribute'

* Add documentation for skipping SuppressMessageAttribute tests

* Fix changelog section header

Author: raandree

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- Added tag `AllowSuppressMessageAttribute` to test `Should not suppress the required rule` to allow usage of `SuppressMessageAttribute` [#135](https://github.com/dsccommunity/DscResource.Test/issues/135).
+
 ## [0.19.0] - 2026-01-23
 
 ### Fixed

README.md

@@ -1174,6 +1174,37 @@ Invoke-Pester -Container $container -Output Detailed
 
 ### PSSAResource.common
 
+This test runs PSScriptAnalyzer against the source files and validates
+compliance with required and custom rules.
+
+#### Skipping tests that validate SuppressMessageAttribute usage
+
+The test `Should not suppress the required rule` validates that no required
+PSSA rules are suppressed using `SuppressMessageAttribute`. If you need to
+suppress a required rule in your module (which is generally not recommended),
+you can exclude this specific test by using the tag `AllowSuppressMessageAttribute`
+with the `ExcludeTagFilter` parameter.
+
+**Example using build.yaml:**
+
+```yaml
+DscTest:
+  Pester:
+    ExcludeTagFilter:
+      - AllowSuppressMessageAttribute
+```
+
+**Example using Invoke-Pester directly:**
+
+```powershell
+$container = New-PesterContainer -Path "$pathToHQRMTests/PSSAResource.common.*.Tests.ps1" -Data @{
+    ProjectPath = '.'
+    ModuleBase = "./output/$dscResourceModuleName/*"
+}
+
+Invoke-Pester -Container $container -ExcludeTagFilter 'AllowSuppressMessageAttribute'
+```
+
 #### Parameters
 
 <!-- markdownlint-disable MD013 - Line length -->

source/Tests/QA/PSSAResource.common.v5.Tests.ps1

@@ -166,7 +166,7 @@ Describe 'Common Tests - PS Script Analyzer on Source Files' -Tag @('DscPSSA', '
             }
         }
 
-        It 'Should not suppress the required rule ''<_>''' -ForEach $requiredRuleToTest -Tag @('Common Tests - Required Script Analyzer Rules', 'RequiredPSSA') {
+        It 'Should not suppress the required rule ''<_>''' -ForEach $requiredRuleToTest -Tag @('Common Tests - Required Script Analyzer Rules', 'RequiredPSSA', 'AllowSuppressMessageAttribute') {
             $_ | Should -Not -BeIn $suppressedRuleNames -Because 'no module script file should suppress a required Script Analyzer rule'
         }