internal/functions/Send-MForgeSingleMail.ps1
|
function Send-MForgeSingleMail { <# .SYNOPSIS Sends an email using MailForge with template support and configurable mail parameters. .DESCRIPTION This function sends an email using MailForge. It supports sending via a named template, template file, or a temporary template. All mail parameters from Initialize-MForgeMailDefault can be optionally provided. The function allows flexible template usage and mail configuration. The following parameters can be set as defaults using Initialize-MForgeMailDefault: Credential, SMTPServer, Port, From, RecipientList, CCList, BCCList, UseSecureConnectionIfAvailable, ConfigScope. .PARAMETER Credential Credentials for authenticating with the SMTP server. .PARAMETER SMTPServer The name or address of the SMTP server. .PARAMETER Port The port to use for connecting to the SMTP server. .PARAMETER From The sender address (MailboxAddress). .PARAMETER RecipientList List of recipient addresses (InternetAddressList). .PARAMETER CCList List of CC recipient addresses (InternetAddressList). .PARAMETER BCCList List of BCC recipient addresses (InternetAddressList). .PARAMETER UseSecureConnectionIfAvailable Indicates whether to use a secure connection if available. .PARAMETER Subject The subject of the email. .PARAMETER TemplateParameters Parameters to pass to the template for mail generation. Mandatory. .PARAMETER TemplateName The name of the existing template to use. Mandatory in ParameterSet 'ByName'. .PARAMETER TemplateFile The path to the template file to use. Mandatory in ParameterSet 'ByFile'. .EXAMPLE Send-MForgeSingleMail -TemplateName 'MyTemplate' -TemplateParameters $params Sends an email using the template 'MyTemplate' and the provided parameters. .NOTES If -WhatIf is specified, the mail information (recipient, subject, content) will be displayed on the console, but no mails will be sent. #> [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')] param ( # Optional parameters from Initialize-MForgeMailDefault [pscredential]$Credential, [string]$SMTPServer, [int]$Port, $From, # MailboxAddress $RecipientList, # InternetAddressList $CCList, # InternetAddressList $BCCList, # InternetAddressList [boolean]$UseSecureConnectionIfAvailable, [string]$Subject, # Mandatory parameters [Parameter(Mandatory = $true)] $TemplateParameters, # ParameterSet ByName [Parameter(Mandatory = $true, ParameterSetName = 'ByName')] [string]$TemplateName, # ParameterSet ByFile [Parameter(Mandatory = $true, ParameterSetName = 'ByFile')] [string]$TemplateFile, [Parameter(Mandatory = $true, ParameterSetName = 'ByString')] [string]$TemplateString, [Parameter(Mandatory = $true, ParameterSetName = 'ByString')] [ValidateSet("TXT", "HTML", "MD")] [string]$TemplateType = "TXT" ) Write-PSFMessage "`$WhatIfPreference=$($WhatIfPreference)" $sendMailParams = Get-MForgeMailDefault -CurrentPSBoundParameters $PSBoundParameters if ($PSCmdlet.ParameterSetName -ne 'ByName') { $registerParam=$PSBoundParameters|convertto-psfhashtable -Include 'TemplateString','TemplateFile','TemplateType' Write-PSFMessage "Registering temporary template with parameters: $($registerParam|ConvertTo-Json -Compress)" # $templateName = Register-MForgeTemplate -TemplateFile $TemplateFile -Temporary $templateName = Register-MForgeTemplate @registerParam -Temporary } $template = Get-PSMDTemplate $TemplateName if (-not $template) { Stop-PSFFunction -Level Warning -Message "Template $TemplateName not found" return } $templateResults=Invoke-mforgeTemplate -TemplateName $TemplateName -TemplateParameters $TemplateParameters # $templateResults = Invoke-PSMDTemplate -TemplateName $TemplateName -Parameters $TemplateParameters -GenerateObjects switch -Regex (($template).Tags | Join-String -Separator ',') { 'MD' { Write-PSFMessage "Konvertiere MarkDown nach HTML" # $mdContent = $templateResults | Select-Object -First 1 -ExpandProperty Content $sendMailParams.HtmlBody = ($templateResults | ConvertFrom-Markdown).Html } 'HTML' { Write-PSFMessage "Erzeuge HTML aus dem Template" $sendMailParams.HtmlBody = $templateResults # | Select-Object -First 1 -ExpandProperty Content } } Write-PSFMessage "SendMail-Params: $($sendMailParams | ConvertTo-Json -Compress)" if ($WhatIfPreference) { Write-PSFMessage "WhatIf is set, no mails will be sent. The following mails would be sent:" # Write-PSFMessage -Level Host -Message "$($sendMailParams|Select-Object -Property RecipientList,Subject,HtmlBody | ConvertTo-Json)" Write-PSFMessage -Level Host -Message @" RecipientList=$($sendMailParams.RecipientList) Subject=$($sendMailParams.Subject) HtmlBody=$($sendMailParams.HtmlBody) "@ } else { Invoke-PSFProtectedCommand -Action "Sending Mail to $($sendMailParams.RecipientList)" -ScriptBlock { Send-MailKitMessage @sendMailParams } } if ($PSCmdlet.ParameterSetName -eq 'ByFile') { Remove-PSMDTemplate -TemplateName $TemplateName -Confirm:$false -ErrorAction SilentlyContinue } } |