Start-Sleep
指定された期間、スクリプトまたはセッションでアクティビティを中断します。
構文
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 |
入力
このコマンドレットには、秒数をパイプ処理できます。
出力
None
このコマンドレットは、出力を返しません。
メモ
PowerShell には、次のエイリアスが Start-Sleep
含まれています。
Windows の場合:
sleep
Ctrl+C
から抜け出しますStart-Sleep
。Ctrl+C
から抜け出[Threading.Thread]::Sleep
すことはありません. 詳細については、「Thread.Sleep メソッド」を参照してください。
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示