Udostępnij przez

Start-Sleep

Moduł:
Microsoft.PowerShell.Utility Module

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

Składnia

Seconds (Domyślna) 

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

Milliseconds 

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

FromTimeSpan 

Start-Sleep
    -Duration <TimeSpan>
    [<CommonParameters>]

Opis

Polecenie cmdlet Start-Sleep zawiesza działanie w skrypcie lub sesji na określony czas. 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 polecenia Get-Date, dopóki czasomierz uśpienia nie wygaśnie.

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

W tym przykładzie wszystkie polecenia w sesji są wstrzymane 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ć wartością ujemną TimeSpan i nie może przekraczać [int]::MaxValue milisekund.

Ten parametr został dodany w programie PowerShell 7.3.

Właściwości parametru

Typ:TimeSpan
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ts

Zestawy parametrów

FromTimeSpan
Position:Named
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Milliseconds

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

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:milisekundy

Zestawy parametrów

Milliseconds
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Double
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Seconds
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Int32

Możesz przekierować liczbę 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-Sleep:

  • Windows:

    • sleep

  • Ctrl+C ucieka z Start-Sleep.

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