xRemoteDesktopSessionHost

1.7.0.0

tests/unit/MSFT_xRDServer.tests.ps1

$script:DSCModuleName      = '.\xRemoteDesktopSessionHost'
$script:DSCResourceName    = 'MSFT_xRDServer'

#region HEADER

# Unit Test Template Version: 1.2.1
$script:moduleRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
Write-Output @('clone','https://github.com/PowerShell/DscResource.Tests.git',"'"+(Join-Path -Path $script:moduleRoot -ChildPath '\DSCResource.Tests')+"'")

if ( (-not (Test-Path -Path (Join-Path -Path $script:moduleRoot -ChildPath 'DSCResource.Tests'))) -or `
     (-not (Test-Path -Path (Join-Path -Path $script:moduleRoot -ChildPath 'DSCResource.Tests\TestHelper.psm1'))) )
{
    & git @('clone','https://github.com/PowerShell/DscResource.Tests.git',(Join-Path -Path $script:moduleRoot -ChildPath 'DSCResource.Tests'),'--verbose')
}

Import-Module -Name (Join-Path -Path $script:moduleRoot -ChildPath (Join-Path -Path 'DSCResource.Tests' -ChildPath 'TestHelper.psm1')) -Force

$TestEnvironment = Initialize-TestEnvironment `
    -DSCModuleName $script:DSCModuleName `
    -DSCResourceName $script:DSCResourceName `
    -TestType Unit

#endregion HEADER

function Invoke-TestSetup {

}

function Invoke-TestCleanup {
    Restore-TestEnvironment -TestEnvironment $TestEnvironment

}

# Begin Testing

try
{
    Invoke-TestSetup

    InModuleScope $script:DSCResourceName {
        $script:DSCResourceName    = 'MSFT_xRDServer'
        
        Import-Module RemoteDesktop -Force

        #region Function Get-TargetResource
        Describe "$($script:DSCResourceName)\Get-TargetResource" {
            Mock -CommandName Get-RDServer -MockWith {
                [pscustomobject]@{
                    Server = 'connectionbroker.lan'
                    Roles = @(
                        'RDS-CONNECTION-BROKER'
                    )
                }
            }
            
            Mock -CommandName Get-RDDeploymentGatewayConfiguration -MockWith {
                [pscustomobject]@{
                    GatewayExternalFqdn = 'testgateway.external.fqdn'
                }
            }
            
            It 'Given a server that does not exist in the deployment, Get returns nothing' {
                Get-TargetResource -Server does.not.exist -ConnectionBroker connectionbroker.lan -Role RDS-Connection-Broker | Should BeNullOrEmpty
            }
            
            $getResult = Get-TargetResource -Server connectionbroker.lan -ConnectionBroker connectionbroker.lan -Role RDS-Connection-Broker
            It 'Given a server connectionbroker.lan with the role RDS-CONNECTION-BROKER in the deployment, get returns property <Property> for this server' {
                param (
                    [string]$Property
                )
                
                $getResult.$Property | Should Not BeNullOrEmpty
            } -TestCases @(
                @{
                    Property = 'ConnectionBroker'
                }
                @{
                    Property = 'Server'
                }
                @{
                    Property = 'Role'
                }
            )
            
            Mock -CommandName Get-RDServer -MockWith {
                [pscustomobject]@{
                    Server = 'connectionbroker.lan'
                    Roles = @(
                        'RDS-CONNECTION-BROKER'
                        'RDS-GATEWAY'
                    )
                }
            }
            
            $getResult = Get-TargetResource -ConnectionBroker connectionbroker.lan -Server connectionbroker.lan -Role RDS-Gateway
            It 'Given a server with gateway role, the External Gateway FQDN is returned by Get' {
                $getResult.GatewayExternalFqdn | Should Be 'testgateway.external.fqdn'
            }
        }
        #endregion
        
        #region Function Test-TargetResource
        Describe "$($script:DSCResourceName)\Test-TargetResource" {
            Mock -CommandName Get-RDServer -MockWith {
            
                if($Role -eq 'RDS-Connection-Broker') {
                    [pscustomobject]@{
                        Server = 'connectionbroker.lan'
                        Roles = @(
                            'RDS-CONNECTION-BROKER'
                        )
                    }
                }
            }
            
            Mock -CommandName Get-RDDeploymentGatewayConfiguration -MockWith {
                [pscustomobject]@{
                    GatewayExternalFqdn = 'testgateway.external.fqdn'
                }
            }
            
            It 'Given a new server in the deployment, test returns false' {
                Test-TargetResource -Server does.not.exist -ConnectionBroker connectionbroker.lan -Role RDS-Connection-Broker | Should be $false
            }
            
            It 'Given an existing server in the deployment, but with an unassigned role, test returns false' {
                Test-TargetResource -Server connectionbroker.lan -ConnectionBroker connectionbroker.lan -Role RDS-Gateway | Should be $false
            }
            
            It 'Given an existing server in the deployment, with an existing role, test returns true' {
                Test-TargetResource -Server connectionbroker.lan -ConnectionBroker connectionbroker.lan -Role RDS-Connection-Broker | Should be $true
            }
        }
        #endregion

        #region Function Set-TargetResource
        Describe "$($script:DSCResourceName)\Set-TargetResource" {
            Context "Parameter Values,Validations and Errors" {

                It "Should error when if role is RDS-Gateway and GatewayExternalFqdn is missing." {
                    {Set-TargetResource -ConnectionBroker "connectionbroker.lan" -Server "server1" -Role "RDS-Gateway"} `
                        | should throw
                }
            }
        }
        #endregion

    }
}
finally
{
    #region FOOTER
    Invoke-TestCleanup
    #endregion
}