Partilhar via


Start-Sleep

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

Sintaxe

Seconds (Predefinição)

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

Milliseconds

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

Description

O cmdlet Start-Sleep 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 segundo

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

Start-Sleep -Seconds 1

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 comando Get-Date até que o temporizador de suspensão expire.

Parâmetros

-Milliseconds

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Milliseconds
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Seconds
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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 Windows PowerShell inclui os seguintes aliases para Start-Sleep:

  • sleep

  • Ctrl+C irrompe de Start-Sleep.

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