Start-Sleep

在指定的时间段内将脚本或会话中的活动挂起。

语法

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

说明

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 个命令。

参数

-Milliseconds

指定资源休眠的时间(以毫秒为单位)。 参数可以缩写为 m

Type:Int32
Aliases:ms
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Seconds

指定资源休眠的时间(以秒为单位)。 可以省略参数名称,也可以将其缩写为 s。 从 PowerShell 6.2.0 开始,此参数现在接受小数点值。

Type:Double
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

Int32

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

输出

None

此 cmdlet 不返回任何输出。

备注

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