Compartilhar via

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>]
    [<CommonParameters>]
Wait-Process
    [-Id] <Int32[]>
    [[-Timeout] <Int32>]
    [<CommonParameters>]
Wait-Process
    [[-Timeout] <Int32>]
    -InputObject <Process[]>
    [<CommonParameters>]

Description

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 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: Parar 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 o processo ser interrompido antes de continuar com o próximo comando.

O primeiro comando usa o Get-Process cmdlet para obter a ID do processo do Bloco de Notas. Ele armazena a ID na $nid variável.

O segundo comando usa o Stop-Process cmdlet para interromper o processo com a ID armazenada em $nid.

O terceiro comando usa Wait-Process para 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 especificação de um processo para Wait-Process. O primeiro comando obtém o processo do Bloco de Notas e o armazena na $p 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 .

Esses comandos têm os mesmos resultados e podem ser usados alternadamente.

Exemplo 3: Aguardar processos por um horário especificado

PS C:\> Wait-Process -Name outlook, winword -Timeout 30

Esse comando espera 30 segundos até 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 finalização e o prompt de comando.

Parâmetros

-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 obtém 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

-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

Process

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

Saídas

None

Este cmdlet não gera saída.

Observações

O cmdlet só tem suporte em plataformas Windows.

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