Wait-Process

  • Referência
Módulo:
Microsoft.PowerShell.Management

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

Este 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, em seguida, 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 em $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 armazena-o $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 de forma intercambiável.

Exemplo 3: Aguarde processos por um tempo especificado

Neste exemplo, Wait-Process aguarda 30 segundos para que os processos Outlook e Winword parem. Se ambos os processos não forem interrompidos, o cmdlet exibirá um erro não terminativo e o prompt de comando.

Wait-Process -Name outlook, winword -Timeout 30

Parâmetros

-Any

Quando vários processos são passados para Wait-Processo , 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 restantes processos continuam a decorrer.

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 IDs de processo dos processos. Para especificar vários IDs, use vírgulas para separá-los. Para encontrar 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 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 exibe um erro de não terminação que lista os processos que ainda estão em execução e encerra 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

Process

Você pode canalizar um objeto de processo para este cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

Process

O cmdlet retorna objetos de processo quando você usa o parâmetro PassThru .

Notas

  • Este cmdlet usa o método WaitForExit da classe System.Diagnostics.Process .

  • Ao contrário Start-Process -Waitdo , Wait-Process aguarda apenas os processos identificados. Start-Process -Wait Aguarda que a árvore de processos (o processo e todos os seus descendentes) saia antes de retornar o controle.