Sdílet prostřednictvím

Start-Sleep

  • Reference
Modul:
Microsoft.PowerShell.Utility

Pozastaví aktivitu ve skriptu nebo relaci po zadanou dobu.

Syntaxe

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

Description

Rutina Start-Sleep pozastaví aktivitu ve skriptu nebo relaci po zadanou dobu. Můžete ho použít pro mnoho úloh, například čekání na dokončení operace nebo pozastavení před opakováním operace.

Příklady

Příklad 1: Pozastavení provádění po dobu 1,5 sekund

V tomto příkladu se provádění příkazů pozastaví po dobu jedné a půl sekundy.

Start-Sleep -Seconds 1.5

Příklad 2: Pozastavení provádění na příkazovém řádku

Tento příklad ukazuje, že spuštění je pozastaveno po dobu 5 sekund při spuštění z příkazového řádku.

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 nemůže spustit druhý Get-Date příkaz, dokud nevyprší časovač režimu spánku.

Příklad 3: Příkazy režimu spánku pomocí **TimeSpan**

Tento příklad nastaví všechny příkazy v relaci do režimu spánku po dobu 30 sekund.

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

Parametry

-Duration

Pomocí objektu TimeSpan určuje, jak dlouho prostředek spí v milisekundách. Hodnota nesmí být záporná hodnota TimeSpan a nesmí překročit [int]::MaxValue milisekundy.

Tento parametr byl přidán v PowerShellu 7.3.

Typ:TimeSpan
Aliasy:ts
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Milliseconds

Určuje, jak dlouho prostředek spí v milisekundách. Parametr lze zkrátit jako m.

Typ:Int32
Aliasy:ms
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Seconds

Určuje, jak dlouho prostředek v sekundách spí. Název parametru můžete vynechat nebo ho můžete zkrátit jako s. Počínaje PowerShellem 6.2.0 teď tento parametr přijímá desetinné hodnoty.

Typ:Double
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

Int32

Do této rutiny můžete zadat počet sekund.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C vypadne Start-Sleepz .

  • Ctrl+C se nerozlouchá [Threading.Thread]::Sleep. Další informace naleznete v tématu Thread.Sleep Metoda.