Register Worker Task
Zuletzt geändert: 14.03.2026 05:56

Register-WorkerTask #

ÜBERSICHT #

Registriert eine geplante Windows-Aufgabe zur zyklischen Ausführung eines PowerShell-Skripts.

SYNTAX #

Register-WorkerTask [-TaskName] <string> [-ScriptPath] <string> [[-WorkingDir] <string>]
    [[-IntervalMinutes] <int>] [[-Description] <string>] [[-TaskPath] <string>] [-User] <string>
    [-PlainPassword] <string> -UseSystemAccount

BESCHREIBUNG #

Die Funktion Register-WorkerTask erstellt eine geplante Windows-Aufgabe (Scheduled Task), die ein PowerShell-Skript in einem konfigurierbaren Intervall zyklisch ausführt. Unterstützt werden sowohl das SYSTEM-Konto als auch ein Benutzerkonto mit Klartext-Kennwort. Parallele Ausführung wird automatisch verhindert (IgnoreNew) und es gilt keine Zeitbegrenzung.

PARAMETER #

-TaskName #

Type: string

Anzeigename der geplanten Aufgabe.

-ScriptPath #

Type: string

Pfad zum PS1-Skript.

-WorkingDir #

Type: string
Default: (Split-Path -Path $ScriptPath -Parent)

Arbeitsverzeichnis für die Aufgabe (Standard: Verzeichnis von ScriptPath).

-IntervalMinutes #

Type: int
Default: 5

Wiederholungsintervall in Minuten (Standard: 5).

-Description #

Type: string
Default: "EULANDA PowerShell Worker Task"

Beschreibung im Aufgabenplaner.

-TaskPath #

Type: string
Default: "\EULANDA\"

Aufgabenordner (Standard: “\EULANDA").

-UseSystemAccount #

Type: switch
Mandatory: True

Task wird unter SYSTEM registriert.

-User #

Type: string
Mandatory: True

Benutzername (z. B. “EulandaWorker” ohne .\ oder DOMAIN).

-PlainPassword #

Type: string
Mandatory: True

Passwort im Klartext.

BEISPIELE #

Register-WorkerTask -TaskName "Worker" -ScriptPath "C:\...\Start.ps1" -UseSystemAccount
Register-WorkerTask -TaskName "Worker" -ScriptPath "C:\...\Start.ps1" -User "EulandaWorker" -PlainPassword "abc123"