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).