Wait-Process

参考

模块:: Microsoft.PowerShell.Management

等到进程停止后再接受更多输入。

语法

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>]

说明

此 cmdlet 在 Linux 或 macOS 上不起作用。

Wait-Process cmdlet 等到一个或多个运行的进程停止后再接受输入。在 PowerShell 控制台中，此 cmdlet 禁止显示命令提示符，直到进程停止。可以通过进程名称或进程 ID (PID) 来指定进程，也可以通过管道将进程对象传递给 Wait-Process。

Wait-Process 仅对在本地计算机上运行的进程有效。

示例

示例 1：停止进程并等待

此示例停止 Notepad 进程，然后等到该进程停止后，再继续下一个命令。

$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid

Get-Process cmdlet 获取 Notepad 进程的进程 ID，并将其存储在 $nid 变量中。 Stop-Process 停止 ID 存储在 $nid 中的进程。 Wait-Process 等待 Notepad 进程停止。

示例 2：指定进程

此示例演示了三种不同的方法来指定要 Wait-Process 的进程。第一个命令获取 Notepad 进程并将它存储在 $p 变量中。第二个命令使用 Id 参数，第三个命令使用 Name 参数，第四个命令使用 InputObject 参数。

$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p

这些命令的结果相同，因此可以互换。

示例 3：在指定时间内等待进程

在此示例中，Wait-Process 用 30 秒的时间等待 Outlook 和 Winword 进程停止。如果这两个进程均未停止，则该 cmdlet 会显示非终止错误以及命令提示符。

Wait-Process -Name outlook, winword -Timeout 30

参数

-Any

当有多个进程传入 Wait-Process 后，cmdlet 会等待所有进程都退出后才返回。使用此参数时，cmdlet 会在任何进程退出时返回。之后其余进程会继续运行。

此参数已在 PowerShell 7.4 中添加。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

指定进程的进程 ID。若要指定多个 ID，请使用逗号分隔 ID。若要查找进程的 PID，请键入 Get-Process。

类型:	Int32[]
别名:	PID, ProcessId
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InputObject

通过提交进程对象来指定进程。输入包含进程对象的变量，或键入获取进程对象的命令或表达式（如 Get-Process cmdlet）。

类型:	Process[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定进程的进程名称。若要指定多个名称，请使用逗号分隔这些名称。不支持通配符。

类型:	String[]
别名:	ProcessName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PassThru

默认情况下，此 cmdlet 不会输出任何内容。使用此参数时，cmdlet 会返回表示等待的进程的对象。

此参数已在 PowerShell 7.4 中添加。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Timeout

指定此 cmdlet 等待指定进程停止的最长时间，以秒为单位。当此时间间隔到期时，该命令会显示一个非终止错误（列出仍在运行的进程）并结束等待。默认情况下没有任何超时。

类型:	Int32
别名:	TimeoutSec
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Process

可以将进程对象通过管道传递给此 cmdlet。

输出

None

默认情况下，此 cmdlet 不返回任何输出。