共用方式為

Start-Sleep

  • 參考
模組:
Microsoft.PowerShell.Utility

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

語法

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

Description

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

範例

範例 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 命令。

範例 3：使用 **TimeSpan** 的睡眠命令

此範例會讓會話中的所有命令睡眠 30 秒。

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

參數

-Duration

使用 TimeSpan 物件來指定資源以毫秒為單位的睡眠時間長度。 此值不得為負 TimeSpan ，且不得超過 [int]::MaxValue 毫秒。

此參數已在PowerShell 7.3中新增。

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

-Milliseconds

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

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

-Seconds

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

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

輸入

Int32

您可以使用管線將秒數傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列的 Start-Sleep別名：

  • Windows：

    • sleep

  • Ctrl+C中斷。Start-Sleep

  • Ctrl+C 不會中斷 [Threading.Thread]::Sleep。 如需詳細資訊，請參閱 Thread.Sleep 方法。