ScriptMessage

1.0.7

Public/Connect-ScriptMessage.ps1

function Connect-ScriptMessage
{
    <#
        .LINK
        https://github.com/Sekers/ScriptMessage/wiki

        .SYNOPSIS
        Connects to the specified messaging service ahead of sending the message, if required.

        .DESCRIPTION
        Connects to the specified messaging service ahead of sending the message, if required.

        .PARAMETER Service
        Specify the messaging service to connect to.
        .PARAMETER ReturnConnectionInfo
        Returns connection information after performing function.

        .EXAMPLE
        Connect-ScriptMessage -Service MgGraph
        .EXAMPLE
        Connect-ScriptMessage -Service MgGraph -ReturnConnectionInfo
    #>

    [CmdletBinding()]
    param(
        [Parameter(
        Mandatory = $true,
        ValueFromPipeline = $true,
        ValueFromPipelineByPropertyName = $true)]
        [MessagingService]$Service,

        [parameter(
        Position=1,
        Mandatory=$false,
        ValueFromPipeline=$true,
        ValueFromPipelineByPropertyName=$true)]
        [switch]$ReturnConnectionInfo
    )

    begin
    {
        # Set the necessary configuration variables.
        $ScriptMessageConfig = Get-ScriptMessageConfig
        
        # Set the connection parameters.
        $ConnectionParameters = @{
            ServiceConfig = $ScriptMessageConfig.$Service
        }
    }

    process
    {
        # Connect to the proper service.
        switch ($Service)
        {
            MgGraph {Connect-ScriptMessage_MGGraph @ConnectionParameters}
        }
    }

    end
    {
        # Return the connection information, if requested.
        if ($ReturnConnectionInfo)
        {  
            return Get-ScriptMessageContext -Service $Service
        }
    }
}