Partager via

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.

Syntaxe

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.

Ce paramètre a été ajouté dans PowerShell 7.3.

Type:TimeSpan
Alias:ts
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:ms
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.