通过

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：将调试程序附加到使用 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 方法。