notifications.psm1
|
<#
.SYNOPSIS Sends a mail message with error, pending and completed fixes listed in simple HTML tables. .DESCRIPTION Sends a mail message with error, pending and completed fixes listed in simple HTML tables. Uses the Send-MailMessage cmdlet and thus inherits all of its parameters. It overrides the Body and BodyAsHTML parameers. Returns issue fix objects with notification count potentially changed. .PARAMETER Fix The issue fix object to change, typically passed via pipeline. .PARAMETER IgnoreNotificationCount For fixes in Error or Pending status, sends them even if notification count is equal or less then zero and does not decrement the notification count. .PARAMETER Attachments Specifies the path and file names of files to be attached to the email message. You can use this parameter or pipe the paths and file names to Send-MailMessage. .PARAMETER Bcc Specifies the email addresses that receive a copy of the mail but are not listed as recipients of the message. Enter names (optional) and the email address, such as Name <someone@fabrikam.com>. .PARAMETER Body Specifies additional content to append to end of the email message. .PARAMETER Encoding Specifies the type of encoding for the target file. The default value is UTF8NoBOM. .PARAMETER Cc Specifies the email addresses to which a carbon copy (CC) of the email message is sent. Enter names (optional) and the email address, such as Name <someone@fabrikam.com>. .PARAMETER DeliveryNotificationOption Specifies the delivery notification options for the email message. You can specify multiple values. None is the default value. The alias for this parameter is DNO. .PARAMETER From The From parameter is required. This parameter specifies the sender's email address. Enter a name (optional) and email address, such as Name <someone@fabrikam.com>. .PARAMETER SmtpServer Specifies the name of the SMTP server that sends the email message. .PARAMETER Priority Specifies the priority of the email message. Normal is the default. The acceptable values for this parameter are Normal, High, and Low. .PARAMETER Subject The Subject parameter is not required. This parameter specifies the subject of the email message. Defaults to "Results of Invoke-IssueCheck $(Get-Date)" .PARAMETER To The To parameter is required. This parameter specifies the recipient's email address. If there are multiple recipients, separate their addresses with a comma (,). Enter names (optional) and the email address, such as Name <someone@fabrikam.com>. .PARAMETER Credential Specifies a user account that has permission to perform this action. The default is the current user. .PARAMETER UseSsl The Secure Sockets Layer (SSL) protocol is used to establish a secure connection to the remote computer to send mail. By default, SSL is not used. .PARAMETER Port Specifies an alternate port on the SMTP server. The default value is 25, which is the default SMTP port. .EXAMPLE Read-IssueFix | Send-IssueMailMessage -From no-reply@contoso.com -To cares@contoso.com | Write-IssueFix .INPUTS IssueFix .OUTPUTS IssueFix The fix object(s) that were send out via mailmessage, with nofiticatonCount updated (if not IgnoreNotificationCount) #> function Send-IssueMailMessage { Param ( [Parameter(Mandatory=$false,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$false)] [PSObject] $Fix, [Parameter(Mandatory=$false,Position=1,ValueFromPipeline=$false,ValueFromPipelineByPropertyName=$false)] [Switch] $IgnoreNotificationCount, [Parameter(ValueFromPipeline=$false)] [Alias('PsPath')] [ValidateNotNullOrEmpty()] [string[]] ${Attachments}, [ValidateNotNullOrEmpty()] [string[]] ${Bcc}, [Parameter(Position=4)] [ValidateNotNullOrEmpty()] [string] ${Body}, [Alias('BE')] [ValidateNotNullOrEmpty()] [System.Text.Encoding] ${Encoding}, [ValidateNotNullOrEmpty()] [string[]] ${Cc}, [Alias('DNO')] [ValidateNotNullOrEmpty()] [System.Net.Mail.DeliveryNotificationOptions] ${DeliveryNotificationOption}, [Parameter(Mandatory=$true)] [ValidateNotNullOrEmpty()] [string] ${From}, [Parameter(Position=3)] [Alias('ComputerName')] [ValidateNotNullOrEmpty()] [string] ${SmtpServer}, [ValidateNotNullOrEmpty()] [System.Net.Mail.MailPriority] ${Priority}, [Parameter(Mandatory=$false, Position=3)] [Alias('sub')] [string] ${Subject}, [Parameter(Mandatory=$true, Position=2)] [ValidateNotNullOrEmpty()] [string[]] ${To}, [ValidateNotNullOrEmpty()] [pscredential] [System.Management.Automation.CredentialAttribute()] ${Credential}, [switch] ${UseSsl}, [ValidateRange(0, 2147483647)] [int] ${Port} ) Begin { [PSObject[]] $fixes = @() } Process { $fixes += $fix } End { If ($fixes.Count -gt 0) { $fixes = $fixes | Sort-Object -Property sequenceNumber, statusDateTime $pendingFixes = $fixes | Where-Object Status -eq Pending if (!$IgnoreNotificationCount) { $pendingFixes = $pendingFixes | Where-Object notificationCount -gt 0 $pendingFixes = $pendingFixes | Set-IssueFix -DecrementNotificationCount } $completedFixes = $fixes | Where-Object Status -eq Complete if (!$IgnoreNotificationCount) { $completedFixes = $completedFixes | Where-Object notificationCount -gt 0 $completedFixes = $completedFixes | Set-IssueFix -DecrementNotificationCount } $errorFixes = $fixes | Where-Object Status -eq Error if (!$IgnoreNotificationCount) { $errorFixes = $errorFixes | Where-Object notificationCount -gt 0 $errorFixes = $errorFixes | Set-IssueFix -DecrementNotificationCount } [String] $message = "" [String] $errorString = $errorFixes | ConvertTo-Html -Fragment -Property @("statusDateTime", "checkName", "fixDescription", "fixResults") [String] $completedString = $completedFixes | ConvertTo-Html -Fragment -Property @("statusDateTime", "checkName", "fixDescription", "fixResults") [String] $head = @" <style> table { border-collapse: collapse; } table, th, td { border: 1px solid black; } tr:nth-child(even) { background-color: #f2f2f2; } th, td { padding: 15px; text-align: left; } </style> "@ if ($Body) { $passedBody = "<p>$Body</p>" $PSBoundParameters.Remove("Body") | Out-Null } else { $passedBody = "" } $message = $pendingFixes | ConvertTo-Html -Property @("statusDateTime", "checkName", "fixDescription") -Head $head -Title "Results of Invoke-IssueCheck $(Get-Date)" -PostContent "<p><i>Completed Fixes:</i></p> $completedString" -PreContent "<p><i>Errored Fixes:</i></p> $errorString <p><i>Pending Fixes:</i></p>$passedBody" if (!$Subject) { $Subject = "Results of Invoke-IssueCheck $(Get-Date)" } else { $PSBoundParameters.Remove("Subject") | Out-Null } $PSBoundParameters.Remove("Fix") | Out-Null if ($PSBoundParameters.ContainsKey("IgnoreNotificationCount")) { $PSBoundParameters.Remove("IgnoreNotificationCount") | Out-Null } Send-MailMessage -Body $message -BodyAsHtml -Subject $Subject @PSBoundParameters | Out-Null Write-Output $pendingFixes Write-Output $completedFixes Write-Output $errorFixes } } } |