Start-Sleep
在腳本或會話中暫停該活動，持續指定時間。
語法
Seconds (預設值)
Start-Sleep
[-Seconds] <Double>
[<CommonParameters>]
Milliseconds
Start-Sleep
-Milliseconds <Int32>
[<CommonParameters>]
FromTimeSpan
Start-Sleep
-Duration <TimeSpan>
[<CommonParameters>]
Description
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 物件來指定資源的休眠時間（以毫秒計）。 該值不得為負 時間跨 度，且不得超過 [int]::MaxValue 毫秒。
此參數已在PowerShell 7.3中新增。
參數屬性
| 類型: | TimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ts |
參數集
FromTimeSpan
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Milliseconds
指定資源的睡眠時間（以毫秒計）。 參數可縮寫為 m。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 毫秒 |
參數集
Milliseconds
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Seconds
指定資源的睡眠時間（秒數）。 你可以省略參數名稱，也可以縮寫為 s。 從 PowerShell 6.2.0 開始，這個參數現在接受小數值。
參數屬性
| 類型: | Double |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Seconds
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Int32
你可以把秒數輸入到這個指令小說。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
PowerShell 包含下列 Start-Sleep的別名：
窗戶：
sleep
Ctrl+C從 中突破Start-Sleep出來。Ctrl+C不會從 中突破[Threading.Thread]::Sleep。 更多資訊請參閱 Thread.Sleep Method。
