M365FoundationsCISReport

0.1.3

tests/Test-BlockChannelEmails.ps1

function Test-BlockChannelEmails {
    [CmdletBinding()]
    param (
        # Aligned
        # Parameters can be added here if needed
    )

    begin {
        # Dot source the class script if necessary
        #. .\source\Classes\CISAuditResult.ps1
        # Initialization code, if needed
    }

    process {
        # 8.1.2 (L1) Ensure users can't send emails to a channel email address

        # Retrieve Teams client configuration
        $teamsClientConfig = Get-CsTeamsClientConfiguration -Identity Global
        $allowEmailIntoChannel = $teamsClientConfig.AllowEmailIntoChannel

        # Prepare failure reasons and details based on compliance
        $failureReasons = if ($allowEmailIntoChannel) {
            "Emails can be sent to a channel email address"
        }
        else {
            "N/A"
        }

        $details = if ($allowEmailIntoChannel) {
            "AllowEmailIntoChannel is set to True"
        }
        else {
            "AllowEmailIntoChannel is set to False"
        }

        # Create and populate the CISAuditResult object
        $params = @{
            Rec            = "8.1.2"
            Result         = -not $allowEmailIntoChannel
            Status         = if (-not $allowEmailIntoChannel) { "Pass" } else { "Fail" }
            Details        = $details
            FailureReason  = $failureReasons
        }
        $auditResult = Initialize-CISAuditResult @params
    }

    end {
        # Return the audit result
        return $auditResult
    }
}