Start-Sleep
在指定时间段内暂停脚本或会话中的活动。
语法
Seconds （默认值）
Start-Sleep
[-Seconds] <Double>
[<CommonParameters>]
Milliseconds
Start-Sleep
-Milliseconds <Int32>
[<CommonParameters>]
FromTimeSpan
Start-Sleep
-Duration <TimeSpan>
[<CommonParameters>]
说明
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 毫秒。
此参数已在 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
可以通过管道将秒数传递给此 cmdlet。
输出
None
此 cmdlet 不返回任何输出。
备注
PowerShell 包含以下与 Start-Sleep相关的别名：
窗户：
sleep
Ctrl+C从Start-Sleep突围。Ctrl+C不会中断[Threading.Thread]::Sleep。 有关详细信息，请参阅 Thread.Sleep 方法。
