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 程式,請使用的 Get-Process
ID 參數。
範例 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-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 參數名稱是選擇性的。
若要尋找行程的程序識別碼,請輸入 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 |
輸入
您可以使用管線將進程標識碼傳送至此 Cmdlet。
您可以使用管線將進程物件傳送至此 Cmdlet。
您可以使用管線將行程名稱傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 使用 Windows Management Instrumentation (WMI) Win32_Process 類別的 AttachDebugger 方法。 如需這個方法的詳細資訊,請參閱 MSDN 連結庫中的 AttachDebugger 方法 。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應