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

说明

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

此 cmdlet 附加当前为进程注册的调试器。使用此 cmdlet 之前，请验证是否已下载并正确配置调试器。

示例

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

PS C:\> Debug-Process -Name "Windows Powershell"

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

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

PS C:\> Debug-Process -Name "SQL*"

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

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

PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"

此命令将调试器附加到 Winlogon、Explorer 和 Outlook 进程。

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

PS C:\> Debug-Process -Id 1132, 2028

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

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

PS C:\> Get-Process "Windows PowerShell" | Debug-Process

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

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

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

PS C:\> $PID | Debug-Process

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

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

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

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

PS C:\> Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process

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

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

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

PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P

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

第一个命令使用 Get-Process cmdlet 获取计算机上的 Windows 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

输入

System.Int32, System.Diagnostics.Process, System.String

可以将进程 ID（Int32）、进程对象（System.Diagnostics.Process）或进程名称（String）传递给此 cmdlet。

输出

None

此 cmdlet 不生成任何输出。

备注

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

通过