Start-Sleep

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

指定された期間、スクリプトまたはセッションでアクティビティを中断します。

構文

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

説明

コマンドレットは Start-Sleep 、指定した期間、スクリプトまたはセッションのアクティビティを中断します。 操作が完了するのを待つ間、操作を繰り返す前の一時停止中など多くのタスクに使用できます。

例

例 1: 実行を 1.5 秒間一時停止する

この例では、コマンドの実行が 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 のコマンドを実行できません。

例 3: **TimeSpan** を使用するスリープ コマンド

この例では、セッション内のすべてのコマンドを 30 秒間スリープ状態にします。

Start-Sleep -Duration (New-TimeSpan -Seconds 30)

パラメーター

-Duration

TimeSpan オブジェクトを使用して、リソースのスリープ時間をミリ秒単位で指定します。 この値は負 の TimeSpan ではなく、ミリ秒を超 [int]::MaxValue えてはなりません。

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

-Milliseconds

リソースをスリープ状態にする時間をミリ秒単位で指定します。 パラメーターは m と省略できます。

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

-Seconds

リソースをスリープ状態にする時間を秒単位で指定します。 パラメーター名は省略することも、省略することもできます。 PowerShell 6.2.0 以降では、このパラメーターは小数部の値を受け入れるようになりました。

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

入力

Int32

このコマンドレットには、秒数をパイプ処理できます。

出力

None

このコマンドレットは、出力を返しません。

メモ

PowerShell には、次のエイリアスが Start-Sleep含まれています。

  • Windows の場合:

    • sleep

  • Ctrl+C から抜け出します Start-Sleep。

  • Ctrl+C から抜け出 [Threading.Thread]::Sleepすことはありません. 詳細については、「Thread.Sleep メソッド」を参照してください。