Register-WorkerTask

EulandaXtools — Funktionsreferenz

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"