Condividi tramite

Start-Sleep

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Sospende l'attività in uno script o in una sessione per il periodo di tempo specificato.

Sintassi

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

Descrizione

Il Start-Sleep cmdlet sospende l'attività in uno script o in una sessione per il periodo di tempo specificato. Può essere usato per molte attività, ad esempio l'attesa del completamento di un'operazione o la pausa prima di ripetere un'operazione.

Esempio

Esempio 1: Sospendere l'esecuzione per 1,5 secondi

In questo esempio l'esecuzione dei comandi viene sospesa per uno e mezzo secondo.

Start-Sleep -Seconds 1.5

Esempio 2: Sospendere l'esecuzione dalla riga di comando

Questo esempio mostra che l'esecuzione viene sospesa per 5 secondi quando viene eseguita dalla riga di comando.

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 non può eseguire il secondo Get-Date comando fino alla scadenza del timer di sospensione.

Esempio 3: Comandi di sospensione con un **TimeSpan**

In questo esempio tutti i comandi della sessione vengono sospesi per 30 secondi.

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

Parametri

-Duration

Usa un oggetto TimeSpan per specificare il tempo di sospensione della risorsa in millisecondi. Il valore non deve essere un timeSpan negativo e non deve superare [int]::MaxValue i millisecondi.

Questo parametro è stato aggiunto in PowerShell 7.3.

Tipo:TimeSpan
Alias:ts
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Milliseconds

Specifica la durata della sospensione dell'attività della risorsa, espressa in millisecondi. Il parametro può essere abbreviato come m.

Tipo:Int32
Alias:ms
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Seconds

Specifica la durata della sospensione dell'attività della risorsa, espressa in secondi. È possibile omettere il nome del parametro oppure abbreviato come s. A partire da PowerShell 6.2.0, questo parametro ora accetta valori frazionari.

Tipo:Double
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Int32

È possibile inviare tramite pipe il numero di secondi a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

PowerShell include gli alias seguenti per Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C si interrompe da Start-Sleep.

  • Ctrl+C non si interrompe da [Threading.Thread]::Sleep. Per altre informazioni, vedere Metodo Thread.Sleep.