Migrate to Pester 5

.vscode/settings.json

@@ -36,7 +36,14 @@
         "keepachangelog",
         "notin",
         "pscmdlet",
-        "steppable"
+        "steppable",
+        "contoso",
+        "fabrikam",
+        "fourthcoffee",
+        "Lbfo",
+        "HKLM",
+        "HKCU",
+        "RDMA"
     ],
     "cSpell.ignorePaths": [
         ".git"

CHANGELOG.md

@@ -13,6 +13,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Updated pipeline files to match current DSC Community patterns - fixes [Issue #528](https://github.com/dsccommunity/NetworkingDsc/issues/528).
   - Updated HQRM and build steps to use windows-latest image.
   - Update build pieline to pin GitVersion v5.
+- Tests
+  - Update to use Pester 5.
 
 ## [9.0.0] - 2022-05-30
 

RequiredModules.psd1

@@ -1,24 +1,24 @@
 @{
-    PSDependOptions             = @{
+    PSDependOptions                = @{
         AddToPath  = $true
         Target     = 'output\RequiredModules'
         Parameters = @{
             Repository = ''
         }
     }
 
-    InvokeBuild                 = 'latest'
-    PSScriptAnalyzer            = 'latest'
-    Pester                      = '4.10.1'
-    Plaster                     = 'latest'
-    ModuleBuilder               = 'latest'
-    ChangelogManagement         = 'latest'
-    Sampler                     = 'latest'
-    'Sampler.GitHubTasks'       = 'latest'
-    MarkdownLinkCheck           = 'latest'
-    'DscResource.Test'          = 'latest'
-    xDscResourceDesigner        = 'latest'
-    LoopbackAdapter             = 'latest'
+    InvokeBuild                    = 'latest'
+    PSScriptAnalyzer               = 'latest'
+    Pester                         = 'latest'
+    Plaster                        = 'latest'
+    ModuleBuilder                  = 'latest'
+    ChangelogManagement            = 'latest'
+    Sampler                        = 'latest'
+    'Sampler.GitHubTasks'          = 'latest'
+    MarkdownLinkCheck              = 'latest'
+    'DscResource.Test'             = 'latest'
+    xDscResourceDesigner           = 'latest'
+    LoopbackAdapter                = 'latest'
 
     # Build dependencies needed for using the module
     'DscResource.Common'           = 'latest'

build.yaml

@@ -26,29 +26,26 @@ BuildWorkflow:
     - package_module_nupkg
 
   hqrmtest:
-    - DscResource_Tests_Stop_On_Fail
+    - Invoke_HQRM_Tests_Stop_On_Fail
 
   test:
     - Pester_Tests_Stop_On_Fail
+    - Convert_Pester_Coverage
     - Pester_If_Code_Coverage_Under_Threshold
 
   publish:
     - publish_module_to_gallery
     - Publish_Release_To_GitHub
     - Publish_GitHub_Wiki_Content
-    - Create_ChangeLog_GitHub_PR
 
 ####################################################
 #          ModuleBuilder Configuration             #
 ####################################################
 CopyPaths:
   - en-US
   - DSCResources
-  - Modules
 Prefix: prefix.ps1
-Suffix: suffix.ps1
 Encoding: UTF8
-VersionedOutputDirectory: true
 BuiltModuleSubdirectory: builtModule
 
 ModuleBuildTasks:
@@ -87,16 +84,6 @@ NestedModule:
 ####################################################
 
 Pester:
-  # Pester 4 configuration
-  Script:
-    - tests/Unit
-  ExcludeTag:
-  Tag:
-  CodeCoverageOutputFile: JaCoCo_coverage.xml
-  CodeCoverageOutputFileEncoding: ascii
-  CodeCoverageThreshold: 80
-
-  # Pester 5 configuration
   Configuration:
     Run:
       Path:
@@ -120,14 +107,26 @@ Pester:
 #      Pester Configuration (DscResource.Test)     #
 ####################################################
 DscTest:
-  OutputFormat: NUnitXML
-  ExcludeTag:
-    - 'Common Tests - New Error-Level Script Analyzer Rules'
-  ExcludeSourceFile:
-    - output
-  ExcludeModuleFile:
-    - Modules/DscResource.Common
-  MainGitBranch: main
+  Pester:
+    Configuration:
+      Filter:
+        ExcludeTag:
+          - 'Common Tests - New Error-Level Script Analyzer Rules'
+      Output:
+        Verbosity: Detailed
+        CIFormat: Auto
+      TestResult:
+        Enabled: true
+        OutputFormat: NUnitXML
+        OutputEncoding: ascii
+        OutputPath: ./output/testResults/NUnitXml_HQRM_Tests.xml
+  Script:
+    ExcludeSourceFile:
+      - output
+    ExcludeModuleFile:
+      - Modules/DscResource.Common
+      - NetworkingDsc.ps1
+    MainGitBranch: main
 
 ####################################################
 #              PSDepend Configuration              #
@@ -163,7 +162,7 @@ DscResource.DocGenerator:
       - '\*(.+?)\*' # Match Italic (asterisk)
   Publish_GitHub_Wiki_Content:
     Debug: false
-  Generate_Wiki_Content:
+  Generate_Markdown_For_DSC_Resources:
     MofResourceMetadata:
       Type: MofResource
       Category: Resources
@@ -174,5 +173,5 @@ DscResource.DocGenerator:
       Type: CompositeResource
       Category: Resources
   Generate_Wiki_Sidebar:
-     Debug: false
-     AlwaysOverwrite: true
+    Debug: false
+    AlwaysOverwrite: true

source/DSCResources/DSC_DefaultGatewayAddress/DSC_DefaultGatewayAddress.psm1

@@ -1,10 +1,5 @@
 $modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules'
 
-# Import the Networking Common Modules
-Import-Module -Name (Join-Path -Path $modulePath `
-        -ChildPath (Join-Path -Path 'NetworkingDsc.Common' `
-            -ChildPath 'NetworkingDsc.Common.psm1'))
-
 Import-Module -Name (Join-Path -Path $modulePath -ChildPath 'DscResource.Common')
 
 # Import Localization Strings
@@ -48,9 +43,6 @@ function Get-TargetResource
             $($script:localizedData.GettingDefaultGatewayAddressMessage)
         ) -join '' )
 
-    $destinationPrefix = Get-NetDefaultGatewayDestinationPrefix `
-        -AddressFamily $AddressFamily
-
     $defaultRoutes = Get-NetDefaultRoute `
         -InterfaceAlias $InterfaceAlias `
         -AddressFamily $AddressFamily
@@ -118,8 +110,8 @@ function Set-TargetResource
         ) -join '' )
 
     $defaultRoutes = @(Get-NetDefaultRoute `
-        -InterfaceAlias $InterfaceAlias `
-        -AddressFamily $AddressFamily)
+            -InterfaceAlias $InterfaceAlias `
+            -AddressFamily $AddressFamily)
 
     # Remove any existing default routes
     foreach ($defaultRoute in $defaultRoutes)
@@ -203,17 +195,17 @@ function Test-TargetResource
     Assert-ResourceProperty @PSBoundParameters
 
     $defaultRoutes = @(Get-NetDefaultRoute `
-        -InterfaceAlias $InterfaceAlias `
-        -AddressFamily $AddressFamily)
+            -InterfaceAlias $InterfaceAlias `
+            -AddressFamily $AddressFamily)
 
     # Test if the Default Gateway passed is equal to the current default gateway
     if ($Address)
     {
         if ($defaultRoutes)
         {
             $nextHopRoute = $defaultRoutes.Where( {
-                $_.NextHop -eq $Address
-            } )
+                    $_.NextHop -eq $Address
+                } )
 
             if ($nextHopRoute)
             {
@@ -302,7 +294,7 @@ function Assert-ResourceProperty
     {
         Assert-IPAddress -Address $Address -AddressFamily $AddressFamily
     }
-} # Assert-ResourceProperty
+}
 
 <#
     .SYNOPSIS
@@ -333,7 +325,7 @@ function Get-NetDefaultGatewayDestinationPrefix
     }
 
     return $destinationPrefix
-} # Get-NetDefaultGatewayDestinationPrefix
+}
 
 <#
     .SYNOPSIS
@@ -366,11 +358,9 @@ function Get-NetDefaultRoute
         -AddressFamily $AddressFamily
 
     return @(Get-NetRoute `
-        -InterfaceAlias $InterfaceAlias `
-        -AddressFamily $AddressFamily `
-        -ErrorAction Stop).Where({
+            -InterfaceAlias $InterfaceAlias `
+            -AddressFamily $AddressFamily `
+            -ErrorAction Stop).Where({
             $_.DestinationPrefix -eq $destinationPrefix
         })
-} # Get-NetDefaultRoute
-
-Export-ModuleMember -function *-TargetResource
+}

source/DSCResources/DSC_DnsClientGlobalSetting/DSC_DnsClientGlobalSetting.psm1

@@ -1,10 +1,5 @@
 $modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules'
 
-# Import the Networking Common Modules
-Import-Module -Name (Join-Path -Path $modulePath `
-        -ChildPath (Join-Path -Path 'NetworkingDsc.Common' `
-            -ChildPath 'NetworkingDsc.Common.psm1'))
-
 Import-Module -Name (Join-Path -Path $modulePath -ChildPath 'DscResource.Common')
 
 # Import Localization Strings
@@ -130,7 +125,7 @@ function Set-TargetResource
             Write-Verbose -Message ( @(
                     "$($MyInvocation.MyCommand): "
                     $($script:localizedData.DnsClientGlobalSettingUpdateParameterMessage) `
-                        -f $parameter.Name,($parameterNewValue -join ',')
+                        -f $parameter.Name, ($parameterNewValue -join ',')
                 ) -join '' )
         } # if
     } # foreach
@@ -263,5 +258,3 @@ function Test-TargetResource
 
     return $desiredConfigurationMatch
 } # Test-TargetResource
-
-Export-ModuleMember -Function *-TargetResource

source/DSCResources/DSC_DnsConnectionSuffix/DSC_DnsConnectionSuffix.psm1

@@ -1,10 +1,5 @@
 $modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules'
 
-# Import the Networking Common Modules
-Import-Module -Name (Join-Path -Path $modulePath `
-        -ChildPath (Join-Path -Path 'NetworkingDsc.Common' `
-            -ChildPath 'NetworkingDsc.Common.psm1'))
-
 Import-Module -Name (Join-Path -Path $modulePath -ChildPath 'DscResource.Common')
 
 # Import Localization Strings
@@ -266,5 +261,3 @@ function Test-TargetResource
 
     return $inDesiredState
 }
-
-Export-ModuleMember -function *-TargetResource

source/DSCResources/DSC_DnsServerAddress/DSC_DnsServerAddress.psm1

@@ -1,10 +1,5 @@
 $modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules'
 
-# Import the Networking Common Modules
-Import-Module -Name (Join-Path -Path $modulePath `
-        -ChildPath (Join-Path -Path 'NetworkingDsc.Common' `
-            -ChildPath 'NetworkingDsc.Common.psm1'))
-
 Import-Module -Name (Join-Path -Path $modulePath -ChildPath 'DscResource.Common')
 
 # Import Localization Strings
@@ -46,7 +41,7 @@ function Get-TargetResource
     )
 
     Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): "
-        $($script:localizedData.GettingDnsServerAddressesMessage)
+            $($script:localizedData.GettingDnsServerAddressesMessage)
         ) -join '')
 
     # Remove the parameters we don't want to splat
@@ -110,7 +105,7 @@ function Set-TargetResource
     )
 
     Write-Verbose -Message ( @("$($MyInvocation.MyCommand): "
-        $($script:localizedData.ApplyingDnsServerAddressesMessage -f $AddressFamily, ($Address -join ','), $InterfaceAlias)
+            $($script:localizedData.ApplyingDnsServerAddressesMessage -f $AddressFamily, ($Address -join ','), $InterfaceAlias)
         ) -join '')
 
     $dnsServerAddressSplat = @{
@@ -140,7 +135,7 @@ function Set-TargetResource
             -ErrorAction Stop
 
         Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): "
-            $($script:localizedData.DNSServersHaveBeenSetCorrectlyMessage)
+                $($script:localizedData.DNSServersHaveBeenSetCorrectlyMessage)
             ) -join '' )
     }
     catch [Microsoft.Management.Infrastructure.CimException]
@@ -203,7 +198,7 @@ function Test-TargetResource
     $desiredConfigurationMatch = $true
 
     Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): "
-        $($script:localizedData.CheckingDnsServerAddressesMessage)
+            $($script:localizedData.CheckingDnsServerAddressesMessage)
         ) -join '' )
 
     # Validate the Address passed or set to empty array if not passed
@@ -228,29 +223,29 @@ function Test-TargetResource
 
     # Get the current DNS Server Addresses based on the parameters given.
     [String[]] $currentAddress = @(Get-DnsClientServerStaticAddress `
-        @PSBoundParameters `
-        -ErrorAction Stop)
+            @PSBoundParameters `
+            -ErrorAction Stop)
 
     # Check if the Server addresses are the same as the desired addresses.
     [Boolean] $addressDifferent = (@(Compare-Object `
-            -ReferenceObject $currentAddress `
-            -DifferenceObject $Address `
-            -SyncWindow 0).Length -gt 0)
+                -ReferenceObject $currentAddress `
+                -DifferenceObject $Address `
+                -SyncWindow 0).Length -gt 0)
 
     if ($addressDifferent)
     {
         $desiredConfigurationMatch = $false
 
         Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): "
-            $($script:localizedData.DNSServersNotCorrectMessage) `
-                -f ($Address -join ','),($currentAddress -join ',')
+                $($script:localizedData.DNSServersNotCorrectMessage) `
+                    -f ($Address -join ','), ($currentAddress -join ',')
             ) -join '' )
     }
     else
     {
         # Test will return true in this case
         Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): "
-            $($script:localizedData.DNSServersSetCorrectlyMessage)
+                $($script:localizedData.DNSServersSetCorrectlyMessage)
             ) -join '' )
     }
     return $desiredConfigurationMatch
@@ -300,5 +295,3 @@ function Assert-ResourceProperty
 
     Assert-IPAddress -Address $Address -AddressFamily $AddressFamily
 } # Assert-ResourceProperty
-
-Export-ModuleMember -function *-TargetResource