Files
windows-updater/docs/notifications.md

4.2 KiB

Benachrichtigungen einrichten

Das Script unterstützt zwei unabhängige Benachrichtigungskanäle, die einzeln oder gleichzeitig genutzt werden können.

ntfy

ntfy ist ein einfacher Push-Notification-Dienst. Es kann die öffentliche Instanz (ntfy.sh) oder ein selbst gehosteter Server verwendet werden.

Einrichtung

  1. Topic wählen - Ein Topic-Name ist wie ein Kanal, auf den man Nachrichten sendet (z.B. windows-updates-meinserver)

  2. App installieren (optional) - ntfy-App für Android, iOS oder Web öffnen und das Topic abonnieren

  3. Token erstellen (optional) - Wenn der ntfy-Server Authentifizierung erfordert, einen Access Token erstellen

  4. Config anpassen:

[Notification]
NtfyEnabled = true
NtfyUrl = https://ntfy.sh
NtfyTopic = windows-updates-meinserver
NtfyToken =
NtfyPriority = default

Prioritäten

Wert Bedeutung
min Keine Vibration, kein Sound
low Keine Vibration
default Standard-Verhalten
high Hohe Priorität mit Sound
urgent Höchste Priorität, durchbricht "Nicht stören"

Das Script verwendet automatisch high für Fehler und Reboot-Benachrichtigungen.

Selbst gehosteter ntfy-Server

Bei einem eigenen ntfy-Server die URL entsprechend anpassen:

NtfyUrl = https://ntfy.mein-server.de
NtfyToken = tk_mein_zugangstoken

E-Mail

Einrichtung

  1. SMTP-Zugangsdaten beschaffen - Diese bekommt man vom E-Mail-Provider oder dem eigenen Mailserver

  2. Config anpassen:

[Notification]
EmailEnabled = true
SmtpServer = smtp.example.com
SmtpPort = 587
SmtpUseSsl = true
SmtpUsername = user@example.com
SmtpPassword = mein-passwort
EmailFrom = updater@example.com
EmailTo = admin@example.com
EmailHtmlReport = true

Mehrere Empfänger

Kommagetrennt in EmailTo:

EmailTo = admin@example.com,ops@example.com,chef@example.com

HTML-Report

Wenn EmailHtmlReport = true gesetzt ist, enthält die E-Mail nach der Update-Installation eine formatierte HTML-Tabelle mit:

  • Hostname und Betriebssystem
  • Datum und Uhrzeit
  • Anzahl erfolgreicher und fehlgeschlagener Updates
  • Tabelle mit allen Updates (KB, Titel, Größe, Ergebnis)
  • Farbcodierung: Grün für Erfolg, Rot für Fehler

Bei EmailHtmlReport = false wird stattdessen eine einfache Text-E-Mail gesendet.

Häufige SMTP-Einstellungen

Provider Server Port SSL
Microsoft 365 smtp.office365.com 587 true
Gmail smtp.gmail.com 587 true
Eigener Server mail.example.com 587 oder 465 true
Lokaler Relay localhost 25 false

Hinweis: Bei Gmail wird ein App-spezifisches Passwort benötigt, kein normales Kontopasswort.

E-Mail ohne Authentifizierung

Bei einem lokalen SMTP-Relay ohne Authentifizierung:

SmtpServer = mailrelay.local
SmtpPort = 25
SmtpUseSsl = false
SmtpUsername =
SmtpPassword =

Benachrichtigungs-Ereignisse

Das Script sendet Benachrichtigungen bei folgenden Ereignissen:

Ereignis Priorität Beschreibung
Keine Updates default Keine Updates verfügbar
Dry-Run Report default Liste der verfügbaren Updates (ohne Installation)
Updates OK default Zusammenfassung aller erfolgreich installierten Updates
Updates mit Fehlern high Zusammenfassung inkl. fehlgeschlagener Updates
Modul-Fehler high PSWindowsUpdate konnte nicht geladen werden
Pre-Hook fehlgeschlagen high Pre-Update Script ist fehlgeschlagen, Updates abgebrochen
Neustart steht an high System wird neugestartet (mit Modus und Zeitpunkt)
Neustart erforderlich high Neustart nötig, aber Auto-Reboot ist deaktiviert

Sicherheitshinweis

Die config.ini enthält möglicherweise Zugangsdaten (SMTP-Passwort, ntfy-Token). Stelle sicher, dass:

  • Die Datei config.ini in .gitignore eingetragen ist (ist standardmäßig der Fall)
  • Die Dateiberechtigungen auf dem Server eingeschränkt sind (nur Administratoren)
  • Das SMTP-Passwort idealerweise ein App-spezifisches Passwort ist, nicht das Hauptpasswort