Wait-Process
Aguarda que os processos sejam interrompidos antes de aceitar mais entradas.
Syntax
Wait-Process
[-Name] <String[]>
[[-Timeout] <Int32>]
[-Any]
[-PassThru]
[<CommonParameters>]
Wait-Process
[-Id] <Int32[]>
[[-Timeout] <Int32>]
[-Any]
[-PassThru]
[<CommonParameters>]
Wait-Process
[[-Timeout] <Int32>]
[-Any]
[-PassThru]
-InputObject <Process[]>
[<CommonParameters>]
Description
Esse cmdlet não funciona no Linux ou macOS.
O Wait-Process
cmdlet aguarda que um ou mais processos em execução sejam interrompidos antes de aceitar a entrada. No console do PowerShell, esse cmdlet suprime o prompt de comando até que os processos sejam interrompidos. Você pode especificar um processo por nome de processo ou ID de processo (PID) ou canalizar um objeto de processo para Wait-Process
.
Wait-Process
Funciona apenas em processos em execução no computador local.
Exemplos
Exemplo 1: Parar um processo e aguardar
Este exemplo interrompe o processo do Bloco de Notas e aguarda que o processo seja interrompido antes de continuar com o próximo comando.
$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid
O Get-Process
cmdlet obtém a ID do processo do Bloco de Notas e a armazena $nid
na variável. Stop-Process
interrompe o processo com o ID armazenado no $nid
. Wait-Process
aguarda até que o processo do bloco de notas seja interrompido.
Exemplo 2: Especificando um processo
Este exemplo mostra três métodos diferentes de especificar um processo para Wait-Process
. O primeiro comando obtém o processo do Bloco de Notas e o armazena $p
na variável. O segundo comando usa o parâmetro Id , o terceiro comando usa o parâmetro Name e o quarto comando usa o parâmetro InputObject .
$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p
Esses comandos têm os mesmos resultados e podem ser usados alternadamente.
Exemplo 3: Aguarde processos por um tempo especificado
Neste exemplo, Wait-Process
aguarda 30 segundos para que os processos do Outlook e do Winword parem. Se ambos os processos não forem interrompidos, o cmdlet exibirá um erro de não finalização e o prompt de comando.
Wait-Process -Name outlook, winword -Timeout 30
Parâmetros
-Any
Quando vários processos são passados para Wait-Process
o , o cmdlet aguarda a saída de todos os processos antes de retornar. Com esse parâmetro, o cmdlet retorna quando qualquer um dos processos é encerrado. Os processos restantes continuam a ser executados.
Esse parâmetro foi adicionado no PowerShell 7.4.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica as identificações de processos dos processos. Para especificar IDs múltiplas, use vírgulas para separá-las.
Para localizar o PID de um processo, digite Get-Process
.
Type: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Especifica os processos enviando objetos de processo. Insira uma variável que contenha os objetos de processo ou digite um comando ou expressão que obtenha os objetos de processo, como o Get-Process
cmdlet.
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica os nomes de processo dos processos. Para especificar vários nomes, use vírgulas para separar os nomes. Não há suporte para caracteres curinga.
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Por padrão, esse cmdlet não gera nada. Com esse parâmetro, o cmdlet retorna objetos que representam os processos que foram aguardados.
Esse parâmetro foi adicionado no PowerShell 7.4.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Especifica o tempo máximo, em segundos, que esse cmdlet aguarda a interrupção dos processos especificados. Quando esse intervalo expira, o comando exibirá um erro de não finalização que lista os processos que estão em execução e termina a espera. Por padrão, não há tempo limite.
Type: | Int32 |
Aliases: | TimeoutSec |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode canalizar um objeto de processo para esse cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
O cmdlet retorna objetos de processo quando você usa o parâmetro PassThru .
Observações
Esse cmdlet usa o método WaitForExit da classe System.Diagnostics.Process .
Ao contrário
Start-Process -Wait
,Wait-Process
apenas aguarda os processos identificados.Start-Process -Wait
Aguarda que a árvore de processo (o processo e todos os seus descendentes) saia antes de retornar o controle.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de