Compartir a través de

Start-Sleep

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Suspende la actividad en un script o en una sesión durante el período de tiempo especificado.

Sintaxis

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

Description

El Start-Sleep cmdlet suspende la actividad en un script o sesión durante el período de tiempo especificado. Se puede usar para muchas tareas, como esperar a que se complete una operación o pausar antes de repetir una operación.

Ejemplos

Ejemplo 1: Pausar la ejecución durante 1,5 segundos

En este ejemplo, la ejecución de comandos se pausa durante uno y medio segundos.

Start-Sleep -Seconds 1.5

Ejemplo 2: Pausar la ejecución en la línea de comandos

En este ejemplo se muestra que la ejecución se pausa durante 5 segundos cuando se ejecuta desde la línea de comandos.

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 no puede ejecutar el segundo Get-Date comando hasta que expire el temporizador de suspensión.

Ejemplo 3: Comandos de suspensión mediante **TimeSpan**

Este ejemplo hace que todos los comandos de la sesión se suspenda durante 30 segundos.

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

Parámetros

-Duration

Usa un objeto TimeSpan para especificar cuánto tiempo se suspende el recurso en milisegundos. El valor no debe ser un TimeSpan negativo y no debe superar [int]::MaxValue los milisegundos.

Este parámetro se agregó en PowerShell 7.3.

Tipo:TimeSpan
Alias:ts
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Milliseconds

Especifica en milisegundos cuánto tiempo se suspende el recurso. El parámetro se puede abreviar como m.

Tipo:Int32
Alias:ms
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Seconds

Especifica en segundos cuánto tiempo se suspende el recurso. Puede omitir el nombre del parámetro o puede abreviarlo como s. A partir de PowerShell 6.2.0, este parámetro ahora acepta valores fraccionarios.

Tipo:Double
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

Int32

Puede canalizar el número de segundos a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C se interrumpe en Start-Sleep.

  • Ctrl+C no se interrumpe en [Threading.Thread]::Sleep. Para obtener más información, vea Thread.Sleep Method.