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-ProcessID 参数。
示例 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-ProcessInputObject 参数在 变量中$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 |
输入
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 方法 。