Condividi tramite


Start-Sleep

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

Sintassi

Seconds (impostazione predefinita).

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

Milliseconds

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

FromTimeSpan

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

Descrizione

Il cmdlet Start-Sleep sospende l'attività in uno script o una sessione per il periodo di tempo specificato. È possibile usarlo per molte attività, ad esempio attendere il completamento o la sospensione di un'operazione 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 comando Get-Date 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 per quanto tempo la risorsa viene sospesa in millisecondi. Il valore non deve essere un TimeSpan negativo e non deve superare [int]::MaxValue millisecondi.

Questo parametro è stato aggiunto in PowerShell 7.3.

Proprietà dei parametri

Tipo:TimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ts

Set di parametri

FromTimeSpan
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Milliseconds

Specifica il tempo di sospensione della risorsa in millisecondi. Il parametro può essere abbreviato come m.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ms

Set di parametri

Milliseconds
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Seconds

Specifica il tempo di sospensione della risorsa in secondi. È possibile omettere il nome del parametro oppure abbreviato come . A partire da PowerShell 6.2.0, questo parametro ora accetta valori frazionari.

Proprietà dei parametri

Tipo:Double
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Seconds
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Int32

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

Output

None

Questo cmdlet non restituisce alcun output.

Note

PowerShell include gli alias seguenti per Start-Sleep:

  • Windows:

    • sleep
  • Ctrl+C si interrompe Start-Sleep.

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