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 Start-Sleep Cmdlet hält die Aktivität in einem Skript oder einer Sitzung für den angegebenen Zeitraum an. Sie können es für viele Aufgaben verwenden, z. B. Warten auf den Abschluss eines Vorgangs oder Anhalten, 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 keine Millisekunden überschreiten [int]::MaxValue .

Dieser Parameter wurde in PowerShell 7.3 hinzugefügt.

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 im Ruhezustand ist. Der Parameter kann als m gekü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 im Ruhezustand ist. Sie können den Parameternamen weglassen, oder Sie können ihn wie folgt abkürten. 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:

  • Windows:

    • sleep

  • Ctrl+Cbricht aus .Start-Sleep

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