Debug-Process
偵錯本機電腦上執行的一或多個處理程序。
Syntax
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Cmdlet 會將 Debug-Process 偵錯工具附加至本機電腦上的一或多個執行中進程。
您可以依處理程序名稱或處理程序識別碼 (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︰將偵錯工具附加到多個處理程序識別碼
PS C:\> Debug-Process -Id 1132, 2028此命令將偵錯工具附加到處理程序識別碼為 1132 和 2028 的處理程序。
範例 5︰使用 Get-Process 取得處理程序，然後將偵錯工具附加到其中
PS C:\> Get-Process "Windows PowerShell" | Debug-Process此命令將偵錯工具附加到電腦上的 PowerShell 處理程序。 它會使用 Get-Process Cmdlet 取得電腦上的 PowerShell 進程，並使用管線運算子 () | 將進程傳送至 Debug-Process Cmdlet。
若要指定特定的 PowerShell 程式，請使用 的 ID Get-Process 參數。
範例 6︰將偵錯工具附加到本機電腦上目前的處理程序
PS C:\> $PID | Debug-Process此命令將偵錯工具附加到電腦上目前的 PowerShell 處理程序。
此命令會 $PID 使用自動變數，其中包含目前 PowerShell 進程的進程識別碼。 然後，它會使用管線運算子 (|) ，將進程識別碼傳送至 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 參數名稱為選擇性。
若要尋找處理程序的處理程序識別碼，請輸入 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
您可以使用管線將處理程序識別碼 (Int32)、處理程序物件 (System.Diagnostics.Process) 或處理程序名稱 (String) 傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會產生任何輸出。
備註
此 Cmdlet 會使用 Windows Management Instrumentation (WMI) Win32_Process 類別的 AttachDebugger 方法。 如需這個方法的詳細資訊，請參閱 MSDN 程式庫中的 AttachDebugger 方法 。