MSGraphMail

1.2.0

Public/New-MSGraphMail.ps1

function New-MSGraphMail {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [String[]]$From,
        [Parameter(Mandatory = $true)]
        [String[]]$To,
        [String[]]$CC,
        [String[]]$BCC,
        [String]$Subject,
        [Parameter(Mandatory = $true)]
        [String]$BodyContent,
        [String]$FooterContent,
        [Parameter(Mandatory = $true)]
        [string]$BodyFormat,
        [String]$Folder,
        [String[]]$Attachments,
        [String[]]$InlineAttachments,
        [Switch]$Draft,
        [Switch]$RequestDeliveryReceipt,
        [Switch]$RequestReadReceipt,
        [Switch]$Pipeline,
        [Switch]$Send,
        [Switch]$SaveandSend
    )
    try {
        $CommandName = $MyInvocation.InvocationName
        $MailFrom = Invoke-EmailStringParser -Strings $From
        $MailTo = Invoke-EmailStringParser -Strings @($To)
        if ($CC) {
            $MailCC = Invoke-EmailStringParser -Strings @($CC)
        } else {
            $MailCC = @()
        }
        if ($BCC) {
            $MailBCC = Invoke-EmailStringParser -Strings @($BCC)
        } else {
            $MailBCC = @()
        }
        $MailBody = New-MSGraphMailBody -BodyFormat $BodyFormat -BodyContent $BodyContent -FooterContent $FooterContent
        $MailParams = @{
            toRecipients = @($MailTo)
            from = $MailFrom
            subject = $Subject
            body = $MailBody
            ccRecipients = @($MailCC)
            bccRecipients = @($MailBCC)
        }
        if ($Draft) {
            $MailParams.isDraft = $true
        }
        if ($RequestDeliveryReceipt) {
            $MailParams.isDeliveryReceiptRequested = $true
        }
        if ($RequestReadReceipt) {
            $MailParams.isReadReceiptRequested = $true
        }
        $RequestURI = [System.UriBuilder]::New('https', 'graph.microsoft.com')
        if ($Folder) {
            $MessageBody = $MailParams
            $RequestURI.Path = "v1.0/users/$($MailFrom.EmailAddress.Address)/mailfolders/$($Folder)/messages"
        } elseif ($Send) {
            $MessageBody = @{
                message = $MailParams
                saveToSentItems = $true
            }
            $RequestURI.Path = "v1.0/users/$($MailFrom.EmailAddress.Address)/sendmail"
        } else {
            $MessageBody = $MailParams
            $RequestURI.Path = "v1.0/users/$($MailFrom.EmailAddress.Address)/messages"
        }
        $POSTRequestParams = @{
            URI = $RequestURI.ToString()
            ContentType = 'application/json'
            Body = $MessageBody
        }
        $Message = New-MSGraphMailPOSTRequest @POSTRequestParams
        Write-Debug "Microsoft Graph returned $($Message)"
        if ($Message) {
            Write-CustomMessage -Message "Created message '$($Message.subject)' with ID $($Message.id)" -Type 'Success'
        }
        if ($Attachments) {
            $AttachmentParams = @{
                Mailbox = $MailFrom.EmailAddress.Address
                MessageID = $Message.id
                Attachments = $Attachments
            }
            New-MSGraphMailAttachment @AttachmentParams | Out-Null
        }
        if ($InlineAttachments) {
            $InlineAttachmentParams = @{
                Mailbox = $MailFrom.EmailAddress.Address
                MessageID = $Message.id
                Attachments = $InlineAttachments
                InlineAttachments = $True
            }
            New-MSGraphMailAttachment @InlineAttachmentParams | Out-Null
        }
        if ($Pipeline -and $Message) {
            $Result = [PSCustomObject]@{
                id = $($Message).id
                mailbox = $MailFrom.EmailAddress.Address
                folder = $($Message).parentFolderId
            }
            Return $Result
        } elseif ($SaveandSend) {
            $SendParams = @{
                MessageID = $($Message).id
                Mailbox = $MailFrom.EmailAddress.Address
                Folder = $($Message).parentFolderId
            }
            Send-MSGraphMail @SendParams
        } elseif ($Message) {
            Return $Message
        }  
    } catch {
        $Command = $CommandName -Replace '-', ''
        $ErrorRecord = @{
            ExceptionType = 'System.Exception'
            ErrorMessage = "$($CommandName) failed."
            InnerException = $_.Exception
            ErrorID = "MicrosoftGraph$($Command)CommandFailed"
            ErrorCategory = 'ReadError'
            TargetObject = $_.TargetObject
            ErrorDetails = $_.ErrorDetails
            BubbleUpDetails = $True
        }
        $CommandError = New-MSGraphErrorRecord @ErrorRecord
        $PSCmdlet.ThrowTerminatingError($CommandError)
    }
}