Partager via

Start-Sleep

Module:
Microsoft.PowerShell.Utility Module

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

Syntaxe

Seconds (Par défaut) 

Start-Sleep
    [-Seconds] <Double>
    [<CommonParameters>]

Milliseconds 

Start-Sleep
    -Milliseconds <Int32>
    [<CommonParameters>]

FromTimeSpan 

Start-Sleep
    -Duration <TimeSpan>
    [<CommonParameters>]

Description

L’applet de commande Start-Sleep suspend l’activité dans un script ou une session pendant la période spécifiée. Vous pouvez l’utiliser pour de nombreuses tâches, telles que l’attente d’une opération ou la suspension 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 commande Get-Date 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 une TimeSpan négative et ne doit pas dépasser [int]::MaxValue millisecondes.

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

Propriétés du paramètre

Type:TimeSpan
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ts

Jeux de paramètres

FromTimeSpan
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Milliseconds

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:milliseconde

Jeux de paramètres

Milliseconds
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Seconds

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

Propriétés du paramètre

Type:Double
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Seconds
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Int32

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

Sorties

None

Cette applet de commande ne retourne aucune sortie.

Notes

PowerShell inclut les alias suivants pour Start-Sleep:

  • Windows :

    • sleep

  • Ctrl+C sauts de Start-Sleep.

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