Debug-Process
调试在本地计算机上运行的一个或多个进程。
语法
Name （默认值）
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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 |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
指定要调试的进程的进程 ID。 Id 参数名称是可选的。
若要查找进程的进程 ID，请键入 Get-Process。
参数属性
| 类型: | Int32[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | PID, ProcessId |
参数集
Id
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InputObject
指定表示待调试进程的进程对象。 输入一个变量，其中包含进程对象或获取进程对象的命令，例如 Get-Process cmdlet。 还可以将进程对象通过管道传送给此 cmdlet。
参数属性
| 类型: | Process[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InputObject
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定要调试的进程的名称。 如果有多个进程具有相同名称，则此 cmdlet 会将调试器附加到具有该名称的所有进程。 Name 参数是可选的。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | ProcessName |
参数集
Name
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
System.Int32, System.Diagnostics.Process, System.String
可以将进程 ID（Int32）、进程对象（System.Diagnostics.Process）或进程名称（String）传递给此 cmdlet。
输出
None
此 cmdlet 将不生成任何输出。
备注
- 此 cmdlet 使用 Windows 管理规范（WMI）中的 Win32_Process 类的 AttachDebugger 方法。 有关此方法的详细信息，请参阅 MSDN 库中 AttachDebugger 方法。