共用方式為


Start-Sleep

暫停文本或會話中指定時段的活動。

語法

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

Description

Start-Sleep Cmdlet 會在指定時間內暫停腳本或會話中的活動。 您可以將它用於許多工作,例如在重複作業之前等待作業完成或暫停。

範例

範例 1:暫停執行 1.5 秒

這個範例會執行一個半秒的命令。

Start-Sleep -Seconds 1.5

範例 2:在命令行暫停執行

此範例顯示從命令行執行時暫停執行 5 秒。

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 無法執行第二個 Get-Date 命令。

參數

-Milliseconds

指定資源以毫秒為單位的睡眠時間。 參數可以縮寫為 m

類型:Int32
別名:ms
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Seconds

指定資源以秒為單位的睡眠時間。 您可以省略參數名稱,也可以將它縮寫為 s。 從 PowerShell 6.2.0 開始,此參數現在接受小數值。

類型:Double
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

Int32

您可以使用管線將秒數傳送至 Start-Sleep

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

  • 您也可以透過內建別名 sleep來參考 Start-Sleep。 如需詳細資訊,請參閱 about_Aliases
  • Ctrl+C 中斷 Start-Sleep
  • Ctrl+C 不會中斷 [Threading.Thread]::Sleep。 如需詳細資訊,請參閱 Thread.Sleep 方法