{"id":3522,"date":"2025-03-13T15:19:51","date_gmt":"2025-03-13T20:19:51","guid":{"rendered":"https:\/\/microsoftgeek.com\/?p=3522"},"modified":"2025-03-13T15:21:38","modified_gmt":"2025-03-13T20:21:38","slug":"active-directory-replication-summary-to-your-email","status":"publish","type":"post","link":"https:\/\/microsoftgeek.com\/?p=3522","title":{"rendered":"Active Directory Replication Summary to your Email"},"content":{"rendered":"\n

Active Directory replication<\/strong> is a critical process that ensures the consistent and up-to-date state of directory information across all domain controllers in a domain. Monitoring this process is important as it helps identify any issues that may arise and resolve them quickly. One way to monitor Active Directory<\/strong> replication is by using the Repadmin command-line tool. Repadmin<\/strong> provides a wealth of information about the replication status and health of a domain. However, manually checking the Repadmin<\/strong> output can be time-consuming and tedious, and running it manually every 30 minutes just to check if everything is great doesn’t seem like a great idea. While PowerShell<\/strong> has its own commands around replication I’ve not found something as fast and reliable as repadmin \/replsummary<\/strong>.<\/p>\n\n\n\n

Replication Summary to an email<\/h3>\n\n\n\n

So, as part of my advanced\u00a0Active Directory<\/strong>\u00a0module called\u00a0ADEssentials<\/strong><\/a>, I wrote a function that uses repadmin to generate results. Then, I use\u00a0PSWriteHTML<\/strong>\u00a0<\/a>to process them and\u00a0Mailozaurr<\/strong>\u00a0to send them to my email. Here’s a how I did it:<\/p>\n\n\n\n

$ReplicationSummary = Get-WinADForestReplicationSummary -IncludeStatisticsVariable Statistics

$Body = EmailBody {
    EmailImage -Source 'https:\/\/companywebsite.xyz\/wp-content\/uploads\/2021\/04\/Logo-evotec-bb.png' -UrlLink '' -AlternativeText 'Logo' -Width 181 -Heigh 57 -Inline

    EmailText -Text \"Dear \", \"AD Team,\" -LineBreak
    EmailText -Text \"Upon reviewing the resuls of replication I've found: \"
    EmailList {
        EmailListItem -Text \"Servers with good replication: \", $($Statistics.Good) -Color Black, SpringGreen -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication failures: \", $($Statistics.Failures) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication delta over 24 hours: \", $($Statistics.DeltaOver24Hours) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication delta over 12 hours: \", $($Statistics.DeltaOver12Hours) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication delta over 6 hours: \", $($Statistics.DeltaOver6Hours) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication delta over 3 hours: \", $($Statistics.DeltaOver3Hours) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Servers with replication delta over 1 hour: \", $($Statistics.DeltaOver1Hours) -Color Black, Red -FontWeight normal, bold
        EmailListItem -Text \"Unique replication errors: \", $($Statistics.UniqueErrors.Count) -Color Black, Red -FontWeight normal, bold
    }

    if ($Statistics.UniqueErrors.Count -gt 0) {
        EmailText -Text \"Unique replication errors:\"
        EmailList {
            foreach ($ErrorText in $Statistics.UniqueErrors) {
                EmailListItem -Text $ErrorText
            }
        }
    } else {
        EmailText -Text \"It seems you're doing a great job! Keep it up! 😊\" -LineBreak
    }

    EmailText -Text \"For more details please check the table below:\"

    EmailTable -DataTable $ReplicationSummary {
        EmailTableCondition -Inline -Name \"Fail\" -HighlightHeaders 'Fails', 'Total', 'PercentageError' -ComparisonType number -Operator gt 0 -BackgroundColor Salmon -FailBackgroundColor SpringGreen
    } -HideFooter

    EmailText -LineBreak
    EmailText -Text \"Kind regards,\"
    EmailText -Text \"Your automation friend\"
}


$EmailSplat = @{
    From           = 'admin@company.com'
    To             = 'users@company.com'
    Body           = $Body
    Priority       = if ($Statistics.Failures -gt 0) { 'High' } else { 'Low' }
    Subject        = 'Replication Results 💖'
    Verbose        = $true
    WhatIf         = $false
    MgGraph        = $true
}

Connect-MgGraph
Send-EmailMessage @EmailSplat<\/pre>\n\n\n\n
What is the result of those 50 lines of code?<\/p>\n\n\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n
<\/a><\/p>\n\n\n\n
The\u00a0Get-WinADForestReplicationSummary<\/strong>\u00a0function joins over 100 functions available for\u00a0Active Directory<\/strong>\u00a0admins in the\u00a0ADEssentials<\/strong><\/a>\u00a0module. It’s doing the heavy lifting of reading repadmin data and converting it to PowerShell objects. Then, we use the PSWriteHTML\u00a0EmailBody<\/strong>\u00a0function, which allows for the accessible building of emails without knowing\u00a0HTML<\/strong>\u00a0and\u00a0CSS<\/strong>. Finally, since I wanted to send an email with\u00a0Microsoft Graph<\/strong>, I’ve used\u00a0Mailozaurr’s<\/strong>\u00a0amazing\u00a0Send-EmailMessage<\/strong>\u00a0to send an email.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Active Directory replication is a critical process that ensures the consistent and up-to-date state of directory information across all domain controllers in a domain. Monitoring this process is important as it helps identify any issues that may arise and resolve them quickly. One way to monitor Active Directory replication is by using the Repadmin command-line tool. Repadmin provides a wealth […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[42,59],"tags":[],"class_list":["post-3522","post","type-post","status-publish","format-standard","hentry","category-ad","category-powershell"],"_links":{"self":[{"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/posts\/3522","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3522"}],"version-history":[{"count":4,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/posts\/3522\/revisions"}],"predecessor-version":[{"id":3528,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=\/wp\/v2\/posts\/3522\/revisions\/3528"}],"wp:attachment":[{"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3522"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3522"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/microsoftgeek.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3522"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}