Files
rdp-login-notifier/docs/task-scheduler.md
2026-04-26 14:36:43 +02:00

68 lines
2.1 KiB
Markdown

# Task-Scheduler einrichten
Die Aufgabe wird durch das Windows-Event **1149** im Log `Microsoft-Windows-TerminalServices-RemoteConnectionManager/Operational` ausgeloest. Dieses Event wird bei jeder erfolgreichen RDP-Anmeldung geschrieben.
## Variante 1 — XML importieren (empfohlen)
Die mitgelieferte Datei `rdp-access-notification.xml` kann direkt importiert werden:
**Per PowerShell:**
```powershell
Register-ScheduledTask -Xml (Get-Content "C:\scripts\rdp-login-notifier\rdp-access-notification.xml" -Raw) -TaskName "RDP Access Notification"
```
**Per Aufgabenplanung (GUI):**
1. Aufgabenplanung oeffnen (`taskschd.msc`)
2. Aktion > Aufgabe importieren
3. Die Datei `rdp-access-notification.xml` auswaehlen
4. Bei Bedarf den Pfad zum Script unter *Aktionen* anpassen
## Variante 2 — Manuell anlegen
### Allgemein
| Einstellung | Wert |
|---|---|
| Name | `RDP Access Notification` |
| Ausfuehren als | `SYSTEM` |
| Unabhaengig von der Benutzeranmeldung ausfuehren | Ja |
| Mit hoechsten Privilegien ausfuehren | Nein |
### Trigger
| Einstellung | Wert |
|---|---|
| Trigger-Typ | Bei einem Ereignis |
| Protokoll | `Microsoft-Windows-TerminalServices-RemoteConnectionManager/Operational` |
| Quelle | `Microsoft-Windows-TerminalServices-RemoteConnectionManager` |
| Ereignis-ID | `1149` |
### Aktion
| Einstellung | Wert |
|---|---|
| Programm/Script | `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` |
| Argumente | `-ExecutionPolicy Bypass -File "C:\scripts\rdp-access-notification.ps1"` |
Der Parameter `-ExecutionPolicy Bypass` sorgt dafuer, dass das Script auch ohne systemweite Aenderung der ExecutionPolicy ausgefuehrt wird. Er gilt nur fuer diesen einen Prozess.
### Einstellungen
| Einstellung | Wert |
|---|---|
| Aufgabe bei Bedarf starten | Ja |
| Aufgabe beenden, falls laenger als | 72 Stunden |
| Nicht starten, falls im Akkubetrieb | Nein |
## Aufgabe testen
Nach dem Anlegen kann die Aufgabe manuell ausgeloest werden:
```powershell
Start-ScheduledTask -TaskName "RDP Access Notification"
```
Oder im Aufgabenplaner per Rechtsklick > *Ausfuehren*.