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.

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 pendant 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 seconde

Dans cet exemple, l’exécution des commandes s’interrompt pendant une seconde et demie.

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’a pas expiré.

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 de veille de la ressource en millisecondes. La valeur ne doit pas être un 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 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éger en tant que . À compter de PowerShell 6.2.0, ce paramètre accepte désormais les 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 se sépare de Start-Sleep.

  • Ctrl+C n’est pas en dehors de [Threading.Thread]::Sleep. Pour plus d’informations, consultez Méthode Thread.Sleep.