Skip to main content

Start-Sleep 💤

Das Cmdlet Start-Sleep pausiert die Ausführung eines Skripts oder einer Befehlssequenz für eine definierte Zeitspanne.

Es wird häufig verwendet, um:

  • Wartezeiten einzubauen

  • Prozesse zu synchronisieren

  • Ressourcen zu schonen (z. B. bei Schleifen)

🔧 Syntax

Start-Sleep [-Seconds] <Double> [<CommonParameters>]

Start-Sleep -Milliseconds <Int32> [<CommonParameters>]

📌 Parameter

-Seconds

  • Typ: Double

  • Pflicht: Ja (wenn -Milliseconds nicht verwendet wird)

  • Gibt die Wartezeit in Sekunden an

  • Dezimalwerte sind erlaubt

Start-Sleep -Seconds 2.5

-Milliseconds

  • Typ: Int32

  • Pflicht: Ja (wenn -Seconds nicht verwendet wird)

  • Gibt die Wartezeit in Millisekunden an

Start-Sleep -Milliseconds 500

⚠️ Hinweise zur Verwendung

  • -Seconds und -Milliseconds dürfen nicht gleichzeitig verwendet werden

  • Während der Ausführung blockiert Start-Sleep den aktuellen Thread vollständig

  • Es erfolgt keine Hintergrundverarbeitung während der Pause

📊 Verhalten

Eigenschaft Beschreibung
Blockierend Ja
Rückgabewert Keiner
Thread-Verhalten Aktueller Thread wird pausiert
Genauigkeit Abhängig vom System-Timer

🧪 Beispiele

Einfaches Warten

Write-Host "Start"
Start-Sleep -Seconds 2
Write-Host "Ende"

Verwendung in Schleifen

for ($i = 1; $i -le 5; $i++) {
    Write-Host "Durchlauf $i"
    Start-Sleep -Seconds 1
}

Kurze Pause in Millisekunden

Start-Sleep -Milliseconds 200

Dynamische Wartezeit

$delay = 1.5
Start-Sleep -Seconds $delay

⚙️ Typische Anwendungsfälle

  • Polling (z. B. auf Datei oder Prozess warten)

  • Debugging (Abläufe verlangsamen)

  • UI-Skripte (z. B. kurz warten, bis Controls geladen sind)

  • API-Rate-Limiting

❗ Alternativen / Ergänzungen

[System.Threading.Thread]::Sleep()

[System.Threading.Thread]::Sleep(1000)

Unterschiede:

  • Arbeitet nur mit Millisekunden

  • Weniger PowerShell-idiomatisch

  • Kein Support für CommonParameters

Start-Sleep vs. Start-Job

Szenario Empfehlung
Einfaches Warten Start-Sleep
Asynchrone Ausführung Start-Job
UI-Responsiveness wichtig Kein Start-Sleep

🚫 Typische Fehler

1. Beide Parameter gleichzeitig verwenden

# ❌ Falsch
Start-Sleep -Seconds 1 -Milliseconds 500

2. UI einfrieren

# ❌ Problematisch in WinForms/WPF
Start-Sleep -Seconds 5

➡️ Blockiert die UI komplett

3. Zu kurze Wartezeiten erwarten hohe Präzision

Start-Sleep -Milliseconds 1

➡️ Systembedingt oft ungenau

🧠 Best Practices

  • Für UI-Anwendungen besser Timer verwenden statt Start-Sleep

  • In Schleifen immer bewusst einsetzen, um CPU-Last zu reduzieren

  • Wartezeiten so kurz wie möglich halten

  • Für präzise Zeitsteuerung ggf. andere Mechanismen nutzen

Wenn du das Ding in einer WinForms-App benutzt, dann frierst du dir halt elegant dein UI ein und wunderst dich danach, warum alles tot wirkt. Klassischer Anfänger-Move, aber immerhin ein lehrreicher.

Back to top