Start-Sleep
Suspende a atividade em um script ou uma sessão para o período de tempo especificado.
Sintaxe
Start-Sleep -Milliseconds <int> [<CommonParameters>] Start-Sleep [-Seconds] <int> [<CommonParameters>]
Descrição
O cmdlet Start-Sleep suspende a atividade em um script ou sessão para o período de tempo especificado. É possível usá-lo para muitas tarefas, como esperar pela conclusão de uma operação ou pausar antes de repetir uma operação.
Parâmetros
-Milliseconds <int>
Especifica por quanto tempo, em milissegundos, o recurso ficará suspenso. O parâmetro pode ser abreviado como "-m".
| Necessário? | true |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByPropertyName) |
| Aceitar caracteres curinga? | false |
-Seconds <int>
Especifica por quanto tempo, em segundos, o recurso ficará suspenso. Você pode omitir o parâmetro name ("Seconds") ou abreviá-lo como "-s".
| Necessário? | true |
| Posição? | 1 |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByValue, ByPropertyName) |
| Aceitar caracteres curinga? | false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
| Entradas | System.Int32
Você pode canalizar o número de segundos para Start-Sleep. |
| Saídas | None
Este cmdlet não retorna nenhuma saída. |
Observações
Você também pode fazer referência a Start-Sleep usando seu alias interno, "sleep". Para obter mais informações, consulte about_Aliases.
Exemplo 1
C:\PS>Start-Sleep -s 15 Descrição ----------- Esse comando faz com que todos os comandos da sessão sejam suspensos por 15 segundos.
Exemplo 2
C:\PS>Start-Sleep -m 500 Descrição ----------- Esse comando faz com que todos os comandos da sessão sejam suspensos por ½ segundo (500 milissegundos).