Start-Sleep

  • Référence
Module:
Microsoft.PowerShell.Utility

Interrompt l'activité dans un script ou une session pour la période spécifiée.

Syntax

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

Description

L’applet Start-Sleep de commande suspend l’activité dans un script ou une session pour la période spécifiée. Vous pouvez l'utiliser pour de nombreuses tâches, comme attendre qu'une opération se termine ou soit suspendue avant de répéter une opération.

Exemples

Exemple 1 : Suspendre l’exécution pendant 1,5 secondes

Dans cet exemple, l’exécution de commandes s’interrompt pendant une et demi secondes.

Start-Sleep -Seconds 1.5

Exemple 2 : Suspendre l’exécution sur la ligne de commande

Cet exemple montre que l’exécution est suspendue pendant 5 secondes lors de l’exécution à partir de la ligne de commande.

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 ne peut pas exécuter la deuxième Get-Date commande tant que le minuteur de veille n’expire pas.

Exemple 3 : Commandes de veille à l’aide d’un **TimeSpan**

Cet exemple montre comment rendre toutes les commandes de la session en veille pendant 30 secondes.

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

Paramètres

-Duration

Utilise un objet TimeSpan pour spécifier la durée pendant laquelle la ressource est en veille en millisecondes. La valeur ne doit pas être un intervalle TimeSpan négatif et ne doit pas dépasser [int]::MaxValue les millisecondes.

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

-Milliseconds

Spécifie la durée pendant laquelle la ressource reste en veille en millisecondes. Le paramètre peut être abrégé en tant que m.

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

-Seconds

Spécifie la durée pendant laquelle la ressource reste en veille en secondes. Vous pouvez omettre le nom du paramètre ou l’abrégé en tant que tel. À compter de PowerShell 6.2.0, ce paramètre accepte désormais des valeurs fractionnaires.

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

Entrées

Int32

Vous pouvez diriger le nombre de secondes vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

PowerShell inclut les alias suivants pour Start-Sleep:

  • Windows :

    • sleep

  • Ctrl+C éclats de Start-Sleep.

  • Ctrl+C ne sort pas de [Threading.Thread]::Sleep. Pour plus d’informations, consultez Thread.Sleep, méthode.