Debug-Process

参考

模块:: Microsoft.PowerShell.Management

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

语法

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-Process cmdlet。

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

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

Debug-Process -Id $PID

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

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

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

示例 7：将调试器附加到多个计算机上的指定进程

Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process

此命令将调试器附加到 Server01 和 Server02 计算机上的 MyApp 进程。

该命令使用 Get-Process cmdlet 在 Server01 和 Server02 计算机上获取 MyApp 进程。它使用管道运算符将进程发送到附加调试器的 Debug-Process cmdlet。

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

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

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

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

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

参数

-Confirm

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

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

-Id

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

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

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

-InputObject

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

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

-Name

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

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

-WhatIf

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

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

输入

Int32

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

Process

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

String

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

输出

None

此 cmdlet 不返回任何输出。

备注

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

通过