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