Start-Sleep
指定した期間、スクリプトまたはセッションのアクティビティを中断します。
構文
Start-Sleep
[-Seconds] <Double>
[<CommonParameters>]
Start-Sleep
-Milliseconds <Int32>
[<CommonParameters>]
説明
Start-Sleep
コマンドレットは、指定した期間、スクリプトまたはセッションのアクティビティを中断します。 操作の完了を待機したり、操作を繰り返す前に一時停止したりするなど、多くのタスクに使用できます。
例
例 1: 実行を 1.5 秒間一時停止する
この例では、1 秒の 1 秒と 2 分の 1 のコマンドの実行例を示します。
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 は、スリープ タイマーの有効期限が切れるまで、2 番目の Get-Date
コマンドを実行できません。
パラメーター
-Milliseconds
リソースのスリープ時間をミリ秒単位で指定します。 このパラメーターは、mと省略できます。
型: | Int32 |
Aliases: | ms |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Seconds
リソースのスリープ時間を秒単位で指定します。 パラメーター名は省略することも、
型: | Double |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
パイプを使用して秒数を Start-Sleep
できます。
出力
None
このコマンドレットは出力を返しません。
メモ
- また、組み込みのエイリアス、
sleep
でStart-Sleep
を参照することもできます。 詳細については、about_Aliasesを参照してください。 -
Ctrl+C
Start-Sleep
から抜け出します. -
Ctrl+C
は[Threading.Thread]::Sleep
から抜け出しません。 詳細については、「Thread.Sleep メソッドの」を参照してください。