XenDesktop7

2.3.1

Tests/Unit/VE_XD7Administrator.Tests.ps1

$here = Split-Path -Parent $MyInvocation.MyCommand.Path;
$sut = (Split-Path -Leaf $MyInvocation.MyCommand.Path).Replace('.Tests.ps1', '')
$moduleRoot = Split-Path -Path (Split-Path -Path $here -Parent) -Parent;
Import-Module (Join-Path $moduleRoot -ChildPath "\DSCResources\$sut\$sut.psm1") -Force;

InModuleScope $sut {

    function Get-AdminAdministrator { }
    function New-AdminAdministrator { }
    function Set-AdminAdministrator { }
    function Remove-AdminAdministrator { }

    Describe 'XenDesktop7\VE_XD7Administrator' {

        $testAdmin = @{ Name = 'Test Administrator'; Ensure = 'Present'; Enabled = $true; }
        $testAdminDisabled = @{ Name = 'Test Administrator'; Ensure = 'Present'; Enabled = $false; }
        $testAdminAbsent = @{ Name = 'Test Administrator'; Ensure = 'Absent'; Enabled = $true; }
        $testCredentials = New-Object System.Management.Automation.PSCredential 'DummyUser', (ConvertTo-SecureString 'DummyPassword' -AsPlainText -Force);

        Context 'Get-TargetResource' {
            Mock -CommandName AssertXDModule -MockWith { };
            Mock -CommandName Add-PSSnapin -MockWith { }

            It 'Returns a System.Collections.Hashtable type' {
                Mock -CommandName Get-AdminAdministrator { return $PSBoundParameters; }

                (Get-TargetResource @testAdmin) -is [System.Collections.Hashtable] | Should Be $true;
            }

            It 'Defaults to "Ensure" = "Present"' {
                (Get-TargetResource @testAdmin).Ensure | Should Be 'Present';
            }

            It 'Invokes script block without credentials by default' {
                Mock -CommandName Invoke-Command -ParameterFilter { $Credential -eq $null -and $Authentication -eq $null } { }

                Get-TargetResource @testAdmin;

                Assert-MockCalled Invoke-Command -ParameterFilter { $Credential -eq $null -and $Authentication -eq $null } -Exactly 1 -Scope It;
            }

            It 'Invokes script block with credentials and CredSSP when specified' {
                $testAdminWithCredentials = $testAdmin.Clone();
                $testAdminWithCredentials['Credential'] = $testCredentials;
                Mock -CommandName Invoke-Command -ParameterFilter { $Credential -eq $testCredentials -and $Authentication -eq 'CredSSP' } { }

                Get-TargetResource @testAdminWithCredentials;

                Assert-MockCalled Invoke-Command -ParameterFilter { $Credential -eq $testCredentials -and $Authentication -eq 'CredSSP' } -Exactly 1 -Scope It;
            }

            It 'Asserts "Citrix.DelegatedAdmin.Admin.V1" snapin is registered' {
                Mock -CommandName AssertXDModule -MockWith { };

                Get-TargetResource @testAdmin;

                Assert-MockCalled AssertXDModule -Scope It;
            }

        } #end context Get-TargetResource

        Context 'Test-TargetResource' {
            Mock -CommandName Get-TargetResource -MockWith { return $testAdmin; }

            It 'Returns a System.Boolean type' {
                (Test-TargetResource @testAdmin) -is [System.Boolean] | Should Be $true;
            }

            It 'Returns True when all properties are correct' {
                Test-TargetResource @testAdmin | Should Be $true;
            }

            It 'Returns True when "Enabled" property is incorrect, but "Ensure" = "Absent"' {
                Mock -CommandName Get-TargetResource -MockWith { return $testAdminAbsent; }

                Test-TargetResource @testAdminAbsent | Should Be $true;
            }

            It 'Returns False when "Enabled" property is incorrect' {
                Mock -CommandName Get-TargetResource -MockWith { return $testAdminDisabled; }

                Test-TargetResource @testAdmin | Should Be $false;
            }

            It 'Returns False when "Ensure" property is incorrect' {
                Mock -CommandName Get-TargetResource -MockWith { return $testAdminAbsent; }

                Test-TargetResource @testAdmin | Should Be $false;
            }

        } #end context Test-TargetResource

        Context 'Set-TargetResource' {
            Mock -CommandName AssertXDModule -MockWith { };
            Mock -CommandName Add-PSSnapin -MockWith { }

            It 'Calls New-AdminAdministrator when administrator does not exist' {
                Mock -CommandName Get-AdminAdministrator -MockWith { }
                Mock -CommandName New-AdminAdministrator -MockWith { }
                Mock -CommandName Invoke-Command -MockWith { & $ScriptBlock; }

                Set-TargetResource @testAdmin;

                Assert-MockCalled -CommandName New-AdminAdministrator -Exactly 1 -Scope It;
            }

            It 'Calls Set-AdminAdministrator when administrator does exist' {
                Mock -CommandName Get-AdminAdministrator -MockWith { return $PSBoundParameters; }
                Mock -CommandName Set-AdminAdministrator -MockWith { }
                Mock -CommandName Invoke-Command -MockWith { & $ScriptBlock; }

                Set-TargetResource @testAdmin;

                Assert-MockCalled -CommandName Set-AdminAdministrator -Exactly 1 -Scope It;
            }

            It 'Calls Remove-AdminAdministrator when "Ensure" = "Absent"' {
                Mock -CommandName Get-AdminAdministrator -MockWith { return $PSBoundParameters; }
                Mock -CommandName Remove-AdminAdministrator -MockWith { }
                Mock -CommandName Invoke-Command -MockWith { & $ScriptBlock; }

                Set-TargetResource @testAdminAbsent;

                Assert-MockCalled -CommandName Remove-AdminAdministrator -Exactly 1 -Scope It;
            }

            It 'Invokes script block without credentials by default' {
                Mock -CommandName Invoke-Command -ParameterFilter { $Credential -eq $null -and $Authentication -eq $null } { }

                Set-TargetResource @testAdmin;

                Assert-MockCalled Invoke-Command -ParameterFilter { $Credential -eq $null -and $Authentication -eq $null } -Exactly 1 -Scope It;
            }

            It 'Invokes script block with credentials and CredSSP when specified' {
                $testAdminWithCredentials = $testAdmin.Clone();
                $testAdminWithCredentials['Credential'] = $testCredentials;
                Mock -CommandName Invoke-Command -ParameterFilter { $Credential -eq $testCredentials -and $Authentication -eq 'CredSSP' } { }

                Set-TargetResource @testAdminWithCredentials;

                Assert-MockCalled Invoke-Command -ParameterFilter { $Credential -eq $testCredentials -and $Authentication -eq 'CredSSP' } -Exactly 1 -Scope It;
            }

            It 'Asserts "Citrix.DelegatedAdmin.Admin.V1" snapin is registered' {
                Mock -CommandName AssertXDModule -MockWith { };

                Set-TargetResource @testAdmin;

                Assert-MockCalled AssertXDModule -Scope It;
            }
        } #end context Set-TargetResource

    } #end describe XD7Administrator
} #end inmodulescope