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：将调试程序附加到计算机上的进程

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 的变量中。

第二个命令使用 Debug-Process cmdlet 的 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

输入

Int32

可以通过管道将进程 ID 传递给此 cmdlet。

Process

可以将进程对象通过管道传递给此 cmdlet。

String

可以通过管道将进程名称传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

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