Debug-Process (Microsoft.PowerShell.Management)

Debug-Process

调试本地计算机上运行的一个或多个进程。

句法

Debug-Process
     [-Name] <String[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Process
     [-Id] <Int32[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Process
     -InputObject <Process[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

描述

Debug-Process cmdlet 将调试器附加到本地计算机上的一个或多个正在运行的进程。您可以按进程名称或进程 ID (PID) 指定进程，也可以通过管道将进程对象传递到此 cmdlet。

此 cmdlet 附加为进程注册的调试器。在使用此 cmdlet 之前，请验证是否已安装并配置调试器。

示例

示例 1：将调试器附加到计算机上的进程

Debug-Process -Name Powershell

此命令将调试器附加到计算机上的 PowerShell 进程。

示例 2：将调试器附加到以指定字符串开头的所有进程

Debug-Process -Name note*

此命令将调试器附加到名称以 note 开头的所有进程。

示例 3：将调试器附加到多个进程

Debug-Process "Winlogon", "Explorer", "Outlook"

此命令尝试将调试器附加到 Winlogon、Explorer 和 Outlook 进程。 Winlogon 是一个受保护的进程。要调试 Winlogon，您必须以管理员身份运行该命令。

示例 4：将调试器附加到多个进程 ID

Debug-Process -Id 1132, 2028

此命令将调试器附加到进程 ID 为 1132 和 2028 的进程。

示例 5：使用 Get-Process 获取进程，然后为其附加调试器

Get-Process PowerShell | Debug-Process

此命令将调试器附加到计算机上的 PowerShell 进程。它使用 Get-Process cmdlet 获取计算机上的 PowerShell 进程，并使用管道运算符 (|) 将进程发送到 Debug-处理 cmdlet。

要指定特定的 PowerShell 进程，请使用 Get-Process 的 ID 参数。

示例 6：将调试器附加到本地计算机上的当前进程

Debug-Process -Id $PID

此命令将调试器附加到计算机上当前的 PowerShell 进程。

该命令使用 $PID 自动变量，其中包含当前 PowerShell 进程的进程 ID。然后，它使用管道运算符 (|) 将进程 ID 发送到 Debug-Process cmdlet。

有关 $PID 自动变量的更多信息，请参阅 about_Automatic_Variables。

示例 7：将调试器附加到使用 InputObject 参数的进程

$P = Get-Process PowerShell
Debug-Process -InputObject $P

此命令将调试器附加到本地计算机上的 PowerShell 进程。

第一个命令使用 Get-Process cmdlet 获取计算机上的 PowerShell 进程。它将生成的流程对象保存在名为 $P 的变量中。

第二个命令使用 Debug-Process cmdlet 的 InputObject 参数来提交 $P 变量中的进程对象。

参数

-Confirm

在运行 cmdlet 之前提示您进行确认。

SwitchParameter

cf

命名

False

False

False

False

-Id

指定要调试的进程的进程ID。 Id 参数名称是可选的。

要查找进程的进程 ID，请输入 Get-Process。

Int32[]

PID, ProcessId

0

None

True

True

False

-InputObject

指定代表要调试的进程的进程对象。输入包含流程对象的变量或获取流程对象的命令，例如 Get-Process cmdlet。您还可以通过管道将进程对象传递给此 cmdlet。

过程[]

命名

None

True

True

False

-Name

指定要调试的进程的名称。如果有多个同名进程，此 cmdlet 会将调试器附加到所有同名进程。 名称参数是可选的。

String[]

ProcessName

0

None

True

True

False

-WhatIf

显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

SwitchParameter

wi

命名

False

False

False

False

输入

Int32

您可以通过管道将进程 ID 传递给此 cmdlet。

流程

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

字符串

您可以通过管道将进程名称传递给此 cmdlet。

输出

无

此 cmdlet 不返回任何输出。

笔记

此 cmdlet 使用 Windows Management Instrumentation (WMI) Win32_Process 类的 AttachDebugger 方法。有关此方法的详细信息，请参阅 MSDN 库中的 AttachDebugger 方法。