Wait-Process
Ожидает остановки процессов, прежде чем принимать дополнительный ввод.
Синтаксис
Wait-Process
[-Name] <String[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[-Id] <Int32[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[[-Timeout] <Int32>]
-InputObject <Process[]>
[<CommonParameters>]
Описание
Этот командлет не работает в Linux или macOS.
Командлет Wait-Process
ожидает остановки одного или нескольких запущенных процессов, прежде чем принимать входные данные. В консоли PowerShell этот командлет отключает командную строку, пока не будут остановлены процессы. Можно указать процесс по имени процесса или идентификатору процесса (PID) или передать объект процесса в Wait-Process
.
Wait-Process
работает только с процессами, выполняемыми на локальном компьютере.
Примеры
Пример 1. Остановка процесса и ожидание
В этом примере процесс Блокнота останавливается, а затем ожидается, пока процесс будет остановлен, прежде чем продолжить выполнение следующей команды.
$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid
Командлет Get-Process
получает идентификатор процесса Блокнота и сохраняет его в переменной $nid
. Stop-Process
останавливает процесс с идентификатором, хранящимся в $nid
. Wait-Process
ожидает остановки процесса Блокнота .
Пример 2. Указание процесса
В этом примере показаны три разных метода задания процесса для Wait-Process
. Первая команда получает процесс Блокнота и сохраняет его в переменной $p
. Во второй команде используется параметр Id , в третьей — параметр Name , а в четвертой — параметр InputObject .
$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p
Эти команды приводят к одинаковому результату и могут быть взаимозаменяемыми.
Пример 3. Ожидание процессов в течение указанного времени
В этом примере Wait-Process
ожидает остановки процессов Outlook и Winword в течение 30 секунд. Если оба процесса не остановлены, командлет отображает непрерывающую ошибку и командную строку.
Wait-Process -Name outlook, winword -Timeout 30
Параметры
-Id
Указывает идентификаторы процессов. При указании нескольких идентификаторов разделяйте их запятыми.
Чтобы найти ИДЕНТИФИКАТОР процесса, введите Get-Process
.
Type: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Указывает процессы с помощью отправки объектов процессов. Введите переменную, содержащую объекты процесса, или введите команду или выражение, которое получает объекты процесса, например Get-Process
командлет .
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имя процессов. При указании нескольких имен разделяйте их запятыми. Подстановочные знаки не поддерживаются.
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Timeout
Указывает максимальное время в секундах, в течение которой этот командлет ожидает остановки указанных процессов. По истечении указанного времени команда отображает не прерывающую ошибку со списком еще выполняющихся процессов и завершает ожидание. По умолчанию время ожидания отсутствует.
Type: | Int32 |
Aliases: | TimeoutSec |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Объект процесса можно передать в этот командлет по конвейеру.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Этот командлет использует метод WaitForExit класса System.Diagnostics.Process .
В отличие от
Start-Process -Wait
,Wait-Process
ожидает только определенных процессов.Start-Process -Wait
ожидает выхода дерева процесса (процесса и всех его потомков) перед возвратом управления.