Tests/Unit/MSFT_xDhcpServerAuthorization.Tests.ps1
|
$Global:DSCModuleName = 'xDhcpServer' $Global:DSCResourceName = 'MSFT_xDhcpServerAuthorization' #region HEADER [String] $moduleRoot = Split-Path -Parent (Split-Path -Parent (Split-Path -Parent $Script:MyInvocation.MyCommand.Path)) if ( (-not (Test-Path -Path (Join-Path -Path $moduleRoot -ChildPath 'DSCResource.Tests'))) -or ` (-not (Test-Path -Path (Join-Path -Path $moduleRoot -ChildPath 'DSCResource.Tests\TestHelper.psm1'))) ) { & git @('clone','https://github.com/PowerShell/DscResource.Tests.git',(Join-Path -Path $moduleRoot -ChildPath '\DSCResource.Tests\')) } else { & git @('-C',(Join-Path -Path $moduleRoot -ChildPath '\DSCResource.Tests\'),'pull') } Import-Module (Join-Path -Path $moduleRoot -ChildPath 'DSCResource.Tests\TestHelper.psm1') -Force $TestEnvironment = Initialize-TestEnvironment ` -DSCModuleName $Global:DSCModuleName ` -DSCResourceName $Global:DSCResourceName ` -TestType Unit #endregion # TODO: Other Optional Init Code Goes Here... # Begin Testing try { #region Pester Tests # The InModuleScope command allows you to perform white-box unit testing on the internal # (non-exported) code of a Script Module. InModuleScope $Global:DSCResourceName { #region Pester Test Initialization ## Mock missing functions function Get-DhcpServerInDc { } function Add-DhcpServerInDc { } ## http://virtualengine.co.uk/2015/mocking-missing-cmdlet-pipelines-with-pester/ function Remove-DhcpServerInDc { [CmdletBinding()] param ( [Parameter(ValueFromPipeline)] $someValue ) } ## Test TargetResource parameters with Ensure = 'Present' $testPresentParams = @{ Ensure = 'Present'; DnsName = 'test1.contoso.com'; IPAddress = '192.168.1.1'; } ## Test TargetResource parameters with Ensure = 'Absent' $testAbsentParams = @{ Ensure = 'Absent'; DnsName = 'test1.contoso.com'; IPAddress = '192.168.1.1'; } ## Authorised server list with test1.contoso.com authorised $fakeDhcpServersPresent = @( @{ IPAddress = '192.168.1.1'; DnsName = 'test1.contoso.com'; }, @{ IPAddress = '192.168.1.2'; DnsName = 'test2.contoso.com'; }, @{ IPAddress = '192.168.1.3'; DnsName = 'test3.contoso.com'; } ) ## Authorised server list with test1.contoso.com not authorised $fakeDhcpServersAbsent = @( @{ IPAddress = '192.168.1.2'; DnsName = 'test2.contoso.com'; }, @{ IPAddress = '192.168.1.3'; DnsName = 'test3.contoso.com'; } ) ## Authorised server list with mismathed DnsName, but matched IPAddress $fakeDhcpServersMismatchDnsName = @( @{ IPAddress = '192.168.1.1'; DnsName = 'test11.contoso.com'; }, @{ IPAddress = '192.168.1.2'; DnsName = 'test2.contoso.com'; }, @{ IPAddress = '192.168.1.3'; DnsName = 'test3.contoso.com'; } ) ## Authorised server list with mismathed IPAddress, but matched DnsName $fakeDhcpServersMismatchIPAddress = @( @{ IPAddress = '192.168.1.11'; DnsName = 'test1.contoso.com'; }, @{ IPAddress = '192.168.1.2'; DnsName = 'test2.contoso.com'; }, @{ IPAddress = '192.168.1.3'; DnsName = 'test3.contoso.com'; } ) #endregion #region Function Get-TargetResource Describe "$($Global:DSCResourceName)\Get-TargetResource" { Mock Assert-Module { }; It 'Returns a [System.Collection.Hashtable] type' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } $result = Get-TargetResource @testPresentParams; $result -is [System.Collections.Hashtable] | Should Be $true; } It 'Returns Ensure is Present when DHCP server authorization exists' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } $result = Get-TargetResource @testPresentParams $result.Ensure | Should Be 'Present'; } It 'Returns Ensure is Absent when DHCP server authorization does not exist' { Mock Get-DhcpServerInDC { } $result = Get-TargetResource @testPresentParams; $result.Ensure | Should Be 'Absent'; } } #endregion Function Get-TargetResource #region Function Test-TargetResource Describe "$($Global:DSCResourceName)\Test-TargetResource" { Mock Assert-Module { }; It 'Returns a [System.Boolean] type' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } $result = Test-TargetResource @testPresentParams; $result -is [System.Boolean] | Should Be $true; } It 'Fails when DHCP Server authorization does not exist and Ensure is Present' { Mock Get-DhcpServerInDC { return $fakeDhcpServersAbsent; } Test-TargetResource @testPresentParams | Should Be $false; } It 'Fails when DHCP Server authorization does exist and Ensure is Absent' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } Test-TargetResource @testAbsentParams | Should Be $false; } It 'Fails when DHCP Server authorization does exist, Ensure is Present but DnsName is wrong' { Mock Get-DhcpServerInDC { return $fakeDhcpServersMismatchDnsName; } Test-TargetResource @testPresentParams | Should Be $false; } It 'Fails when DHCP Server authorization does exist, Ensure is Present but IPAddress is wrong' { Mock Get-DhcpServerInDC { return $fakeDhcpServersMismatchIPAddress; } Test-TargetResource @testPresentParams | Should Be $false; } It 'Passes when DHCP Server authorization does exist and Ensure is Present' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } $result = Test-TargetResource @testPresentParams $result -is [System.Boolean] | Should Be $true; } It 'Passes when DHCP Server authorization does not exist and Ensure is Absent' { Mock Get-DhcpServerInDC { return $fakeDhcpServersAbsent; } $result = Test-TargetResource @testAbsentParams $result -is [System.Boolean] | Should Be $true; } } #endregion Function Test-TargetResource #region Function Set-TargetResource Describe "$($Global:DSCResourceName)\Set-TargetResource" { Mock Assert-Module { }; It 'Calls Add-DhcpServerInDc when Ensure is Present' { Mock Add-DhcpServerInDC { } Set-TargetResource @testPresentParams; Assert-MockCalled Add-DhcpServerInDC -Scope It; } It 'Calls Remove-DhcpServerInDc when Ensure is Present' { Mock Get-DhcpServerInDC { return $fakeDhcpServersPresent; } Mock Remove-DhcpServerInDC { } Set-TargetResource @testAbsentParams; Assert-MockCalled Remove-DhcpServerInDC -Scope It; } } #endregion Function Set-TargetResource #region Function Get-IPv4Address Describe "$($Global:DSCResourceName)\Get-IPv4Address" { It 'Returns a IPv4 address' { $result = Get-IPv4Address; $result -match '\d+\.\d+\.\d+\.\d+' | Should Be $true; } } #endregion Function Get-IPv4Address #region Function Get-Hostname Describe "$($Global:DSCResourceName)\Get-Hostname" { It 'Returns at least the current NetBIOS name' { $hostname = [System.Net.Dns]::GetHostname(); $result = Get-Hostname; $result -match $hostname | Should Be $true; } } #endregion Function Get-Hostname } #end InModuleScope } finally { #region FOOTER Restore-TestEnvironment -TestEnvironment $TestEnvironment #endregion } |