Udostępnij za pośrednictwem

Start-Sleep

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

Zawiesza 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żyć w przypadku wielu zadań, takich jak oczekiwanie na ukończenie operacji lub wstrzymanie przed powtórzeniem operacji.

Przykłady

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

W tym przykładzie wykonywanie poleceń wstrzymuje się przez jedną i pół sekundy.

Start-Sleep -Seconds 1.5

Przykład 2. Wstrzymaj wykonywanie 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 uśpią się 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ą przedziałem czasu i nie może przekraczać [int]::MaxValue milisekund.

Type:TimeSpan
Aliases:ts
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Milliseconds

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

Type:Int32
Aliases:ms
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Double
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 Start-Sleepprogramu :

  • W systemie Windows:

    • sleep

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

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