Udostępnij za pośrednictwem

Start-Sleep

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Wstrzymuje działanie w skrycie lub sesji przez określony okres czasu.

Składnia

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

Opis

Polecenie Start-Sleep cmdlet zawiesza działanie w skrycie lub sesji przez określony okres czasu. Można go używać w przypadku wielu zadań, takich jak oczekiwanie na zakończenie operacji lub wstrzymanie jej przed powtórzeniem operacji.

Przykłady

Przykład 1. Wstrzymaj wykonywanie przez 1,5 sekundy

W tym przykładzie wykonywanie poleceń jest wstrzymywane przez jedną i pół sekundy.

Start-Sleep -Seconds 1.5

Przykład 2. Wstrzymanie wykonywania w wierszu polecenia

W tym przykładzie pokazano, że wykonanie jest wstrzymane przez 5 sekund po uruchomieniu z wiersza polecenia.

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

Program PowerShell nie może wykonać drugiego Get-Date polecenia, dopóki czasomierz uśpienia nie wygaśnie.

Przykład 3. Polecenia uśpienia przy użyciu **przedziału czasu**

W tym przykładzie wszystkie polecenia w sesji są w trybie uśpienia przez 30 sekund.

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

Parametry

-Duration

Używa obiektu TimeSpan, aby określić czas uśpienia zasobu w milisekundach. Wartość nie może być ujemną wartością TimeSpan i nie może przekraczać [int]::MaxValue milisekund.

Ten parametr został dodany w programie PowerShell 7.3.

Typ:TimeSpan
Aliasy:ts
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Milliseconds

Określa, jak długo zasób śpi w milisekundach. Parametr można skrócić jako m.

Typ:Int32
Aliasy:ms
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Seconds

Określa czas uśpienia zasobu w sekundach. Możesz pominąć nazwę parametru lub skrócić ją jako s. Począwszy od programu PowerShell 6.2.0, ten parametr akceptuje teraz wartości ułamkowe.

Typ:Double
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Int32

Możesz przekazać potok liczby sekund do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C wyrywa się z Start-Sleep.

  • Ctrl+C nie wyrwać się z [Threading.Thread]::Sleep. Aby uzyskać więcej informacji, zobacz Thread.Sleep, metoda.