Test-CertificateExpiry.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 31518104-6fba-5fec-aa78-d0e333eac498
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Monitoring Report Windows Backup Certificate PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/test-certificateexpiry.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Findet Zertifikate, die bald ablaufen: auf Webseiten und Diensten im Netz und im Zertifikatsspeicher von Servern.
 
.DESCRIPTION
    Prüft zwei Quellen und fasst sie in einer Liste zusammen:
      1. Endpunkte im Netz (-Endpoint), z. B. Webseiten, Exchange, RD-Gateway, Firewall-Portale.
         Das Skript baut eine TLS-Verbindung auf und liest das Zertifikat aus, das der Dienst ausliefert.
         Damit fällt auch auf, wenn ein neues Zertifikat zwar installiert, aber nicht gebunden ist.
      2. Den Speicher LocalMachine\My auf Windows-Servern (-ComputerName), per PowerShell-Remoting.
 
    Jedes Zertifikat bekommt eine Bewertung: Abgelaufen, Kritisch (unter -CriticalDays), Warnung
    (unter -WarningDays) oder OK. Das Ergebnis erscheint als Tabelle, als HTML-Bericht und auf Wunsch
    per Mail. Der Exitcode ist 0, 1 (Warnung) oder 2 (Kritisch oder abgelaufen).
 
.PARAMETER Endpoint
    Endpunkte als host oder host:port. Ohne Port wird 443 verwendet.
 
.PARAMETER ComputerName
    Windows-Server, deren Speicher LocalMachine\My geprüft wird. "localhost" prüft den eigenen Rechner ohne Remoting.
 
.PARAMETER WarningDays
    Ab wie vielen Resttagen gewarnt wird. Standard: 30.
 
.PARAMETER CriticalDays
    Ab wie vielen Resttagen es kritisch ist. Standard: 7.
 
.PARAMETER ReportPath
    Ordner für den HTML-Bericht. Standard: aktueller Ordner.
 
.PARAMETER SmtpServer
    Optional. Mailserver für den Versand des Berichts.
 
.PARAMETER From
    Absender des Berichts.
 
.PARAMETER To
    Empfänger des Berichts.
 
.PARAMETER OnlyProblems
    Mail nur verschicken, wenn mindestens ein Zertifikat eine Warnung hat.
 
.EXAMPLE
    .\Test-CertificateExpiry.ps1 -Endpoint powerscripting.de, mail.contoso.de, firewall.contoso.de:4443
 
    Prüft drei Endpunkte im Netz.
 
.EXAMPLE
    .\Test-CertificateExpiry.ps1 -ComputerName EX01, RDGW01 -Endpoint owa.contoso.de -WarningDays 45 -SmtpServer mail.contoso.local -From cert@contoso.local -To it@contoso.local -OnlyProblems
 
    Prüft zwei Server und einen Endpunkt und meldet sich nur bei Handlungsbedarf.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Die Prüfung der Endpunkte akzeptiert absichtlich jedes Zertifikat, auch abgelaufene oder
    selbst signierte, denn genau die sollen im Bericht auftauchen. Es werden keine Daten übertragen.
    Zertifikate von Let's Encrypt laufen nach 90 Tagen ab und werden normalerweise nach 60 Tagen
    erneuert. Taucht eins mit unter 30 Tagen auf, klemmt meist die automatische Verlängerung.
#>

[CmdletBinding()]
param(
    [string[]] $Endpoint,
    [string[]] $ComputerName,
    [int] $WarningDays = 30,
    [int] $CriticalDays = 7,
    [string] $ReportPath = (Get-Location).Path,
    [string] $SmtpServer,
    [string] $From,
    [string[]] $To,
    [switch] $OnlyProblems
)

if (-not $Endpoint -and -not $ComputerName) {
    throw 'Bitte -Endpoint und/oder -ComputerName angeben.'
}

$now  = Get-Date
$rows = [System.Collections.Generic.List[object]]::new()

function Get-Rating([datetime] $notAfter) {
    $days = [int][math]::Floor(($notAfter - $now).TotalDays)
    $rating = if ($days -lt 0) { 'Abgelaufen' } elseif ($days -lt $CriticalDays) { 'Kritisch' }
              elseif ($days -lt $WarningDays) { 'Warnung' } else { 'OK' }
    return $days, $rating
}

foreach ($ep in $Endpoint) {
    $hostName, $port = $ep -split ':', 2
    if (-not $port) { $port = 443 }
    $tcp = $null
    try {
        $tcp = [Net.Sockets.TcpClient]::new()
        $connect = $tcp.BeginConnect($hostName, [int]$port, $null, $null)
        if (-not $connect.AsyncWaitHandle.WaitOne(5000)) { throw 'Zeitüberschreitung beim Verbinden' }
        $tcp.EndConnect($connect)
        $ssl = [Net.Security.SslStream]::new($tcp.GetStream(), $false, { $true })
        $ssl.AuthenticateAsClient($hostName)
        $cert = [Security.Cryptography.X509Certificates.X509Certificate2]::new($ssl.RemoteCertificate)
        $days, $rating = Get-Rating $cert.NotAfter
        $san = ($cert.Extensions | Where-Object { $_.Oid.Value -eq '2.5.29.17' } |
            ForEach-Object { $_.Format($false) }) -replace 'DNS-Name=|DNS Name=', ''
        $rows.Add([pscustomobject]@{
            Quelle = "${hostName}:$port"; Bewertung = $rating; Tage = $days
            'Gültig bis' = $cert.NotAfter.ToString('dd.MM.yyyy'); Name = $cert.GetNameInfo('SimpleName', $false)
            Aussteller = $cert.GetNameInfo('SimpleName', $true); Namen = $san; Fingerabdruck = $cert.Thumbprint
        })
    }
    catch {
        $rows.Add([pscustomobject]@{ Quelle = "${hostName}:$port"; Bewertung = 'Nicht erreichbar'; Tage = ''
            'Gültig bis' = ''; Name = $_.Exception.Message; Aussteller = ''; Namen = ''; Fingerabdruck = '' })
    }
    finally { if ($tcp) { $tcp.Dispose() } }
}

$readStore = {
    Get-ChildItem Cert:\LocalMachine\My | Where-Object { -not $_.Archived } |
        Select-Object Subject, Issuer, NotAfter, Thumbprint, HasPrivateKey, FriendlyName
}
foreach ($computer in $ComputerName) {
    try {
        $certs = if ($computer -in 'localhost', '.', $env:COMPUTERNAME) { & $readStore }
                 else { Invoke-Command -ComputerName $computer -ScriptBlock $readStore -ErrorAction Stop }
        foreach ($c in $certs) {
            $days, $rating = Get-Rating $c.NotAfter
            $rows.Add([pscustomobject]@{
                Quelle = "$computer (Speicher)"; Bewertung = $rating; Tage = $days
                'Gültig bis' = $c.NotAfter.ToString('dd.MM.yyyy'); Name = ($c.Subject -replace '^CN=([^,]+).*', '$1')
                Aussteller = ($c.Issuer -replace '^CN=([^,]+).*', '$1'); Namen = $c.FriendlyName; Fingerabdruck = $c.Thumbprint
            })
        }
    }
    catch {
        $rows.Add([pscustomobject]@{ Quelle = "$computer (Speicher)"; Bewertung = 'Nicht erreichbar'; Tage = ''
            'Gültig bis' = ''; Name = $_.Exception.Message; Aussteller = ''; Namen = ''; Fingerabdruck = '' })
    }
}

$order  = @{ 'Abgelaufen' = 0; 'Kritisch' = 1; 'Nicht erreichbar' = 2; 'Warnung' = 3; 'OK' = 4 }
$sorted = $rows | Sort-Object { $order[$_.Bewertung] }, Tage
$crit   = @($rows | Where-Object { $_.Bewertung -in 'Abgelaufen', 'Kritisch' }).Count
$warn   = @($rows | Where-Object { $_.Bewertung -in 'Warnung', 'Nicht erreichbar' }).Count
$status = if ($crit) { 'KRITISCH' } elseif ($warn) { 'WARNUNG' } else { 'OK' }
$exit   = if ($crit) { 2 } elseif ($warn) { 1 } else { 0 }

$sorted | Format-Table Quelle, Bewertung, Tage, 'Gültig bis', Name -AutoSize

$title = "[$status] Zertifikate - $($now.ToString('dd.MM.yyyy'))"
$css   = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>'
$html  = $sorted | ConvertTo-Html -Title $title -Head $css `
    -PreContent "<h2>$title</h2><p>$($rows.Count) Zertifikate: $crit kritisch oder abgelaufen, $warn mit Warnung. Schwellen: $WarningDays und $CriticalDays Tage.</p>" | Out-String
$file  = Join-Path $ReportPath ("Zertifikate_{0:yyyy-MM-dd}.html" -f $now)
$html | Set-Content -Path $file -Encoding UTF8
Write-Host "Bericht: $file"

if ($SmtpServer -and $From -and $To -and (-not $OnlyProblems -or $exit -gt 0)) {
    Send-MailMessage -SmtpServer $SmtpServer -From $From -To $To -Subject $title -Body $html -BodyAsHtml -Encoding UTF8
}

exit $exit