Compartir vía

Start-Sleep

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

Seconds (Es el valor predeterminado). 

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

Milliseconds 

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

FromTimeSpan 

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

Description

El cmdlet Start-Sleep suspende la actividad en un script o sesión durante el período de tiempo especificado. Puede usarlo para muchas tareas, como esperar a que una operación se complete o pausa 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 comando Get-Date 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 suspendan durante 30 segundos.

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

Parámetros

-Duration

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

Este parámetro se agregó en PowerShell 7.3.

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ts

Conjuntos de parámetros

FromTimeSpan
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Milliseconds

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ms

Conjuntos de parámetros

Milliseconds
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Seconds

Especifica cuánto tiempo el recurso está inactivo en segundos. 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.

Propiedades del parámetro

Tipo:Double
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Seconds
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Int32

Se puede canalizar el número de segundos a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

PowerShell incluye los siguientes alias para Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C sale de Start-Sleep.

  • Ctrl+C no sale de [Threading.Thread]::Sleep. Para obtener más información, consulte Método Thread.Sleep.