Start-Sleep
暫停腳本或會話中指定時段的活動。
語法
Seconds (預設值)
Start-Sleep
[-Seconds] <Double>
[<CommonParameters>]
Milliseconds
Start-Sleep
-Milliseconds <Int32>
[<CommonParameters>]
FromTimeSpan
Start-Sleep
-Duration <TimeSpan>
[<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 命令。
範例 3：使用 **TimeSpan** 的睡眠命令
此範例會讓會話中的所有命令暫停 30 秒。
Start-Sleep -Duration (New-TimeSpan -Seconds 30)
參數
-Duration
使用 TimeSpan 物件來指定資源以毫秒為單位的睡眠時間長度。 此值不得為負 TimeSpan，且不得超過 [int]::MaxValue 毫秒。
參數屬性
| 類型: | TimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 目前，我不了解"ts"在這個情境中的確切意義。請提供更詳細的資訊或背景，使翻譯更準確並確保忠實於原意。如果"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
您可以使用管線將秒數傳送至此 cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
PowerShell 包含下列 Start-Sleep的別名：
窗戶：
sleep
Ctrl+C跳出Start-Sleep。Ctrl+C不會退出[Threading.Thread]::Sleep。 如需詳細資訊，請參閱 Thread.Sleep 方法。