Compartilhar via

Start-Sleep

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

Seconds (Default) 

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

Milliseconds 

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

FromTimeSpan 

Start-Sleep
    -Duration <TimeSpan>
    [<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 esperar que uma operação seja concluída 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 é pausada 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 na 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.

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

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

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

Parâmetros

-Duration

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

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ts

Conjuntos de parâmetros

FromTimeSpan
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Milliseconds

Especifica por quanto tempo o recurso fica inativo em milissegundos. O parâmetro pode ser abreviado como m.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ms

Conjuntos de parâmetros

Milliseconds
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Seconds

Especifica por quanto tempo o recurso fica inativo em segundos. Você pode omitir o nome do parâmetro ou abreviar como s. A partir do PowerShell 6.2.0, esse parâmetro agora aceita valores fracionários.

Propriedades do parâmetro

Tipo:Double
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Seconds
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 encaminhar o número de segundos para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O PowerShell inclui os seguintes aliases para Start-Sleep:

  • Windows:

    • sleep

  • Ctrl+C sai de Start-Sleep.

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