Freigeben über

Start-Sleep

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Hält die Aktivität in einem Skript oder einer Sitzung für den angegebenen Zeitraum an.

Syntax

Start-Sleep
     [-Seconds] <Double>
     [<CommonParameters>]
Start-Sleep
     -Milliseconds <Int32>
     [<CommonParameters>]
Start-Sleep
     -Duration <TimeSpan>
     [<CommonParameters>]

Beschreibung

Das cmdlet Start-Sleep hält die Aktivität in einem Skript oder einer Sitzung für den angegebenen Zeitraum an. Sie können es für viele Vorgänge verwenden, z. B. warten, bis ein Vorgang abgeschlossen ist oder anzuhalten, bevor ein Vorgang wiederholt wird.

Beispiele

Beispiel 1: Anhalten der Ausführung für 1,5 Sekunden

In diesem Beispiel wird die Ausführung von Befehlen für eineinhalb Sekunden angehalten.

Start-Sleep -Seconds 1.5

Beispiel 2: Anhalten der Ausführung an der Befehlszeile

Dieses Beispiel zeigt, dass die Ausführung 5 Sekunden lang angehalten wird, wenn sie über die Befehlszeile ausgeführt wird.

PS> Get-Date; Start-Sleep -Seconds 5; Get-Date

Friday, May 13, 2022 9:38:15 AM
Friday, May 13, 2022 9:38:20 AM

PowerShell kann den zweiten Get-Date Befehl erst ausführen, wenn der Energiesparzeitgeber abläuft.

Beispiel 3: Energiesparbefehle mit einem **TimeSpan**

In diesem Beispiel werden alle Befehle in der Sitzung für 30 Sekunden in den Ruhezustand geschlafen.

Start-Sleep -Duration (New-TimeSpan -Seconds 30)

Parameter

-Duration

Verwendet ein TimeSpan- -Objekt, um anzugeben, wie lange die Ressource in Millisekunden ruhet. Der Wert darf kein negativer TimeSpan- sein und darf [int]::MaxValue Millisekunden nicht überschreiten.

Typ:TimeSpan
Aliase:ts
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Milliseconds

Gibt an, wie lange die Ressource in Millisekunden ruhet. Der Parameter kann mit mabgekürzt werden.

Typ:Int32
Aliase:ms
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Seconds

Gibt an, wie lange die Ressource in Sekunden in den Ruhezustand wechselt. Sie können den Parameternamen weglassen oder sie als kürzen. Ab PowerShell 6.2.0 akzeptiert dieser Parameter jetzt Bruchwerte.

Typ:Double
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Int32

Sie können die Anzahl der Sekunden an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Start-Sleep:

  • Fenster:

    • sleep

  • Ctrl+C aus Start-Sleepausbricht.

  • Ctrl+C bricht nicht aus [Threading.Thread]::Sleep. Weitere Informationen finden Sie unter Thread.Sleep Method.