Debug-Process
调试在本地计算机上运行的一个或多个进程。
语法
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
cmdlet Debug-Process
将调试器附加到本地计算机上的一个或多个正在运行的进程。
可以通过进程名称或进程 ID (PID) 来指定进程,也可以将进程对象通过管道传送给此 cmdlet。
此 cmdlet 将附加当前为该进程注册的调试程序。 使用此 cmdlet 之前,请先验证调试程序是否已下载并正确配置。
示例
示例 1:将调试程序附加到计算机上的进程
PS C:\> Debug-Process -Name "Windows Powershell"
此命令将调试程序附加到计算机上的 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
此命令将调试程序附加到计算机上的 PowerShell 进程。 它使用 Get-Process
cmdlet 获取计算机上的 PowerShell 进程,并使用管道运算符 (|
) 将进程发送到 Debug-Process
cmdlet。
若要指定特定的 PowerShell 进程,请使用 的 Get-Process
ID 参数。
示例 6:将调试程序附加到本地计算机上的当前进程
PS C:\> $PID | Debug-Process
此命令将调试程序附加到计算机上的当前 PowerShell 进程。
命令使用 $PID
自动变量,其中包含当前 PowerShell 进程的进程 ID。 然后,它使用管道运算符 (|
) 将进程 ID 发送到 Debug-Process
cmdlet。
有关自动变量的详细信息 $PID
,请参阅 about_Automatic_Variables。
示例 7:将调试器附加到使用 InputObject 参数的进程
PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P
此命令将调试程序附加到本地计算机上的 PowerShell 进程。
第一个命令使用 Get-Process
cmdlet 获取计算机上的 PowerShell 进程。 它将生成的进程对象保存在名为 的 $P
变量中。
第二个命令使用 cmdlet 的 Debug-Process
InputObject 参数在 变量中$P
提交进程对象。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定要调试的进程的进程 ID。 Id 参数名为可选项。
要查找进程的进程 ID,请键入 Get-Process
。
Type: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
指定表示要调试的进程的进程对象。 输入包含进程对象的变量或获取进程对象的命令,例如 Get-Process
cmdlet。 还可以将进程对象通过管道传送给此 cmdlet。
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定要调试的进程的名称。 如果存在多个同名进程,则此 cmdlet 会将调试程序附加到所有该名称的进程。 Name 参数是可选的。
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将进程 ID 传递给此 cmdlet。
可以将进程对象通过管道传递给此 cmdlet。
可以通过管道将进程名称传递给此 cmdlet。
输出
None
此 cmdlet 不返回任何输出。
备注
此 cmdlet 使用 Windows Management Instrumentation (WMI) Win32_Process 类的 AttachDebugger 方法。 有关此方法的详细信息,请参阅 MSDN 库中的 AttachDebugger 方法 。