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 |