CGMM

0.0.8.36

Tests/CGMM.TargetGroup.Tests.ps1

param (
    $Identity,
    $DomainController
)

# Get the 'raw' distribution group properties
$getPremCGMMDistributionGroupSplat = @{
    Identity    = $Identity
    ErrorAction = 'Stop'
}
If ($null -ne $DomainController) {
    $getPremCGMMDistributionGroup.Add('DomainController',$DomainController)
}
Try {$DistributionGroup = Get-PremCGMMDistributionGroup @getPremCGMMDistributionGroupSplat}
Catch {$Skip.Skip = $True}

Describe "CGMM Exchange On-Premise Tests" -Tag EXOnPrem {
    $Skip = @{Skip=$False}
    # Store and set EAP Value
    $EAPSaved = $Global:ErrorActionPreference
    $Global:ErrorActionPreference = 'Stop'

    If ($null -eq $DistributionGroup) {
        $Skip.Skip = $True
    }

    Context 'Distribution Group Configuration' {
        It 'Distribution Group Query Successful' {
            $DistributionGroup | Should Not BeNullOrEmpty
        }

        # Only run this test if MemberJoinRestriction is ApprovalRequired
        $MJRSkip = @{Skip = $False}
        If ($DistributionGroup.MemberJoinRestriction -ne 'ApprovalRequired' -or $Skip.Skip -eq $True) {
            $MJRSkip = @{Skip = $True}
        }
        It 'MemberJoinRestriction is set to ApprovalRequired and group is managed' @MJRSkip {
            $DistributionGroup.ManagedBy | Should Not BeNullOrEmpty
        }

        It 'Alias does not contain spaces' @Skip {
            $DistributionGroup.Alias | Should Not Match " "
        }

        It 'Alias does not have a period followed by another period' @Skip {
            $DistributionGroup.Alias | Should Not Match "\.\."
        }
    }

    # Validate Users
    Context 'Validate Properties Have Exchange Objects As Members' {
        # Check properties that require members to exist in Exchange On-Premise
        $PropertiesToCheck = @(
            'AcceptMessagesOnlyFromSendersOrMembers','BypassModerationOnlyFromSendersOrMembers',
            'GrantSendOnBehalfTo','ManagedBy','ModeratedBy','RejectedSendersSendersOrMembers'
        )
        ForEach ($Property in $PropertiesToCheck) {
            $PropertySkip = @{Skip = $False}
            $PropertyCount = $DistributionGroup.$Property.count
            If ($Skip.Skip -eq $True -or $PropertyCount -eq 0) {
                $PropertySkip = @{Skip = $True}
            }
            It "All $PropertyCount members in property $Property are available in Exchange On-Premise" @PropertySkip {
                $CaughtMembers = $null
                # Catch members that error. They'll show up in the failed test results
                $CaughtMembers = ForEach ($Member in $DistributionGroup.$Property) {
                    $getPremCGMMRecipientSplat = @{
                        Identity = $Member
                    }
                    If ($null -ne $DomainController) {
                        $getPremCGMMDistributionGroup.Add('DomainController',$DomainController)
                    }
                    Try {$null = Get-PremCGMMRecipient @getPremCGMMRecipientSplat}
                    Catch {
                        $Member
                    }
                }
                $CaughtMembers | Should BeNullOrEmpty
            }
        }
    }

    Context 'Validate Exchange Online Compatibility' {
        If ($Skip.Skip -eq $True) {
            $Skip = @{Skip = $True}
        }

        # Look for DistributionGroupMembers that aren't cloud supported recipient types
        $getPremCGMMDistributionGroupMemberSplat = @{
            Identity    = $Identity
            ErrorAction = 'Stop'
        }
        If ($null -ne $DomainController) {
            $getPremCGMMDistributionGroup.Add('DomainController',$DomainController)
        }
        Try {$DistributionGroupMembers = Get-PremCGMMDistributionGroupMember @getPremCGMMDistributionGroupMemberSplat}
        Catch {$Skip.Skip = $True}

        $SupportedRecipientTypes = @(
            'DynamicDistributionGroup','MailContact','MailNonUniversalGroup',
            'MailUniversalDistributionGroup','MailUniversalSecurityGroup',
            'MailUser','PublicFolder','UserMailbox'
        )

        It 'Distribution Group Members RecipientType Should Be Supported In Cloud' @Skip {
            $NotSupported = ForEach ($Member in $DistributionGroupMembers) {
                If ($SupportedRecipientTypes -notcontains $Member.RecipientType) {
                    $Member.Name
                }
            }
            $NotSupported | Should BeNullOrEmpty
        }

        It 'Distribution Group is Synced to Exchange Online (PrimarySMTPAddress Matches)' @Skip {
            $CloudGroupQuery = Get-CloudCGMMDistributionGroup -Identity $Identity -ErrorAction Stop
            $CloudGroupQuery.PrimarySMTPAddress | Should Be $DistributionGroup.PrimarySMTPAddress
        }
    }
    # Return EAP Value
    $Global:ErrorActionPreference = $EAPSaved
}

Describe "CGMM MSOnline Tests" -Tag MSOnline {
    $Skip = @{Skip=$False}
    If ($Skip.Skip -eq $True) {
        $Skip = @{Skip = $True}
    }
    # Store and set EAP Value
    $EAPSaved = $Global:ErrorActionPreference
    $Global:ErrorActionPreference = 'Stop'

    If ($null -eq $DistributionGroup) {
        $Skip.Skip = $True
    }

    # Return EAP Value
    $Global:ErrorActionPreference = $EAPSaved

    # Get a list of MsolDomains from MSOnline
    Try {
        [array]$MsolDomains = Get-MsolDomain -ErrorAction Stop | Select-Object -Expand Name
    }
    Catch {$Skip.Skip = $True}

    Context 'MSOnline' {
        # Show tests regarding the MSOnline query
        It "MSOnline Successfully Queried" @Skip {
            $Skip.Skip | Should Not Be $True
        }

        It "Found $($MsolDomains.count) MsolDomains" @Skip {
            $MSolDomains | Should Not BeNullOrEmpty
        }
    }

    Context 'MSOnline Email Domain Validation' {
        # Confirm the group was found & has addresses
        It 'Distribution Group EmailAddresses Property Has Addresses' @Skip {
            $DistributionGroup.EmailAddresses | Should Not BeNullOrEmpty
        }

        # Validate all assigned SMTP addresses are valid Msol domains
        [array]$SMTPAddresses = $EmailAddresses | Where-Object {$_ -match '^SMTP:'}
        [array]$Domains = ForEach ($Address in $SMTPAddresses) {
            $Address.Split("@")[1]
        }
        [array]$UniqueDomains = $Domains | Select-Object -Unique
        ForEach ($UniqueDomain in $UniqueDomains) {
            It "Domain $UniqueDomain Exists in MSOnline" @Skip {
                $MsolDomains -contains $UniqueDomain | Should Be $True
            }
        }
    }
}

Describe "CGMM Exchange Online Tests" -Tag EXOnline {
    $Skip = @{Skip=$False}
    If ($Skip.Skip -eq $True) {
        $Skip = @{Skip = $True}
    }

    # Store and set EAP Value
    $EAPSaved = $Global:ErrorActionPreference
    $Global:ErrorActionPreference = 'Stop'

    # Query for the CGMMTargetGroup.
    Try {
        $GroupObject = Get-CGMMTargetGroup -Identity $Identity -DomainController $DomainController
    }
    Catch {$Skip.$Skip = $True}

    # Validate Users
    Context 'Validate Members Exist in Exchange Online' {
        It "Get-CGMMTargetGroup successfully queries" {
            $GroupObject | Should Not BeNullOrEmpty
        }

        # Check properties that require members to exist in Exchange Online
        $PropertiesToCheck = @(
            'AcceptMessagesOnlyFromSmtpAddresses','BypassModerationOnlyFromSmtpAddresses',
            'GrantSendOnBehalfToSmtpAddresses','ManagedBySmtpAddresses',
            'Members','ModeratedBySmtpAddresses','RejectedSendersSmtpAddresses'
        )
        ForEach ($Property in $PropertiesToCheck) {
            # Save the Skip value to reset
            $PropertySkip = @{Skip = $False}
            $PropertyCount = $GroupObject.$Property.count
            If ($Skip.Skip -eq $True -or $PropertyCount -eq 0) {
                $PropertySkip = @{Skip = $True}
            }
            It "All $PropertyCount members in property $Property are available in Exchange Online" @PropertySkip {
                $CaughtMembers = $null
                $CaughtMembers = ForEach ($Member in $GroupObject.$Property) {
                    Try {$null = Get-CloudCGMMRecipient $Member}
                    Catch {
                        $Member
                    }
                }
                $CaughtMembers | Should BeNullOrEmpty
            }
        }
    }

    # Return EAP Value
    $Global:ErrorActionPreference = $EAPSaved
}