Partilhar via

Start-Sleep

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Suspende a atividade em um script ou sessão pelo período de tempo especificado.

Sintaxe

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

Description

O Start-Sleep cmdlet suspende a atividade em um script ou sessão pelo período de tempo especificado. Você pode usá-lo para muitas tarefas, como aguardar a conclusão de uma operação ou pausar antes de repetir uma operação.

Exemplos

Exemplo 1: Pausar a execução por 1,5 segundos

Neste exemplo, a execução de comandos pausa por um segundo e meio.

Start-Sleep -Seconds 1.5

Exemplo 2: Pausar a execução na linha de comando

Este exemplo mostra que a execução é pausada por 5 segundos quando executada a partir da linha de 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

O PowerShell não pode executar o segundo Get-Date comando até que o temporizador de suspensão expire.

Exemplo 3: Comandos de suspensão usando um **TimeSpan**

Este exemplo faz com que todos os comandos da sessão durmam por 30 segundos.

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

Parâmetros

-Duration

Usa um objeto TimeSpan para especificar quanto tempo o recurso permanece suspenso em milissegundos. O valor não deve ser um TimeSpan negativo e não deve exceder [int]::MaxValue milissegundos.

Esse parâmetro foi adicionado no PowerShell 7.3.

Tipo:TimeSpan
Aliases:ts
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Milliseconds

Especifica quanto tempo o recurso permanece suspenso em milissegundos. O parâmetro pode ser abreviado como m.

Tipo:Int32
Aliases:ms
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Seconds

Especifica quanto tempo o recurso permanece em repouso em segundos. Você pode omitir o nome do parâmetro ou abrevia-lo como s. A partir do PowerShell 6.2.0, esse parâmetro agora aceita valores fracionários.

Tipo:Double
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

Int32

Você pode canalizar o número de segundos para esse cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

O PowerShell inclui os seguintes aliases para Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C rompe de Start-Sleep.

  • Ctrl+C não rompe de [Threading.Thread]::Sleep. Para obter mais informações, consulte Método Thread.Sleep.