Start-Sleep

在指定时间段内暂停脚本或会话中的活动。

语法

Seconds (默认值)

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

Milliseconds

Start-Sleep
    -Milliseconds <Int32>
    [<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 命令。

参数

-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

可以通过管道将秒数传递给 Start-Sleep

输出

None

此 cmdlet 不返回任何输出。

备注

  • 还可以通过其内置别名 Start-Sleep来引用 sleep。 有关详细信息,请参阅 about_Aliases
  • Ctrl+CStart-Sleep突围。
  • Ctrl+C 不会中断 [Threading.Thread]::Sleep。 有关详细信息,请参阅 Thread.Sleep 方法