Wait-Process
Aguarda que os processos sejam interrompidos antes de aceitar mais entradas.
Sintaxe
Name (Default)
Wait-Process
[-Name] <String[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Id
Wait-Process
[-Id] <Int32[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
InputObject
Wait-Process
[[-Timeout] <Int32>]
-InputObject <Process[]>
[<CommonParameters>]
Description
O cmdlet Wait-Process 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 PID (ID de processo) ou redirecionar um objeto de processo para Wait-Process.
Wait-Process funciona apenas em processos em execução no computador local.
Exemplos
Exemplo 1: interromper um processo e aguardar
PS C:\> $nid = (Get-Process notepad).Id
PS C:\> Stop-Process -Id $nid
PS C:\> Wait-Process -Id $nid
Este exemplo interrompe o processo do Bloco de Notas e aguarda que o processo seja interrompido antes de continuar com o próximo comando.
O primeiro comando usa o cmdlet Get-Process para obter a ID do processo do Bloco de Notas. Ele armazena a ID na variável $nid.
O segundo comando usa o cmdlet Stop-Process para interromper o processo com a ID armazenada em $nid.
O terceiro comando usa Wait-Process aguardar até que o processo do Bloco de Notas seja interrompido. Ele usa o parâmetro ID de Wait-Process para identificar o processo.
Exemplo 2: Especificando um processo
PS C:\> $p = Get-Process notepad
PS C:\> Wait-Process -Id $p.Id
PS C:\> Wait-Process -Name "notepad"
PS C:\> Wait-Process -InputObject $p
Esses comandos mostram 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 na variável $p.
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.
Esses comandos têm os mesmos resultados e podem ser usados de forma intercambiável.
Exemplo 3: Aguardar processos por um horário especificado
PS C:\> Wait-Process -Name outlook, winword -Timeout 30
Esse comando aguarda 30 segundos para que os processos do Outlook e do Winword sejam interrompidos. Se ambos os processos não forem interrompidos, o cmdlet exibirá um erro de não encerramento e o prompt de comando.
Parâmetros
-Id
Especifica as IDs de processo dos processos. Para especificar várias IDs, use vírgulas para separar as IDs.
Para localizar o PID de um processo, digite Get-Process.
Propriedades do parâmetro
| Tipo: | Int32[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PID, ProcessId |
Conjuntos de parâmetros
Id
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 obtém os objetos de processo, como o cmdlet Get-Process.
Propriedades do parâmetro
| Tipo: | Process[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InputObject
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | ProcessName |
Conjuntos de parâmetros
Name
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Timeout
Especifica o tempo máximo, em segundos, que esse cmdlet aguarda que os processos especificados sejam interrompidos. Quando esse intervalo expira, o comando exibe um erro de não encerramento que lista os processos que ainda estão em execução e encerra a espera. Por padrão, não há tempo limite.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | TimeoutSec |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| 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
Process
Você pode canalizar um objeto de processo para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
Esse cmdlet usa o método WaitForExit da classe System.Diagnostics.Process.
Ao contrário de
Start-Process -Wait,Wait-Processespera apenas pelos processos identificados.Start-Process -Waitaguarda a saída da árvore de processo (o processo e todos os seus descendentes) antes de retornar o controle.
