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>]
Description
Debug-Process Cmdlet 會將調試程式附加至本機電腦上的一或多個執行中進程。
您可以依行程名稱或進程識別碼 （PID） 來指定進程，也可以使用管線將進程物件傳送至此 Cmdlet。
此 Cmdlet 會連接到註冊於程序的偵錯工具。 使用此 Cmdlet 之前，請確認調試程式已安裝並設定。
範例
範例 1：將調試程式附加至電腦上的進程
Debug-Process -Name powershell
此命令會將調試程式附加至電腦上的PowerShell進程。
範例 2：將調試程式附加至以指定字串開頭的所有進程
Debug-Process -Name note*
此命令會將調試程式附加至名稱開頭為 note的所有進程。
範例 3：將調試程式附加至多個進程
Debug-Process "Winlogon", "Explorer", "Outlook"
此命令會嘗試將調試程式附加至 Winlogon、Explorer 和 Outlook 進程。 Winlogon 是受保護的程式。 若要偵錯 Winlogon，您必須以系統管理員身分執行命令。
範例 4：將調試程式附加至多個進程標識碼
Debug-Process -Id 1132, 2028
此命令會將調試程式附加至進程標識碼為 1132 和 2028 的進程。
範例 5：使用 Get-Process 取得進程，然後將調試程式附加至其中
Get-Process powershell | Debug-Process
此命令會將調試程式附加至電腦上的PowerShell進程。 它會使用 Get-Process Cmdlet 取得電腦上的 PowerShell 進程，並使用管線運算符 （|） 將行程傳送至 Debug-Process Cmdlet。
若要指定特定的 PowerShell 程式，請使用 的 Get-Process 參數。
範例 6：將除錯器附加至本機電腦上的目前程序
Debug-Process -Id $PID
此命令會將調試程式附加至電腦上的目前 PowerShell 進程。
此命令會使用 $PID 自動變數，其中包含目前 PowerShell 進程的進程識別碼。 然後，它會使用管線運算符 （|） 將進程標識碼傳送至 Debug-Process Cmdlet。
如需 $PID 自動變數的詳細資訊，請參閱 about_Automatic_Variables。
範例 7：將調試程式附加至使用 InputObject 參數的進程
$P = Get-Process powershell
Debug-Process -InputObject $P
此命令會將調試程式附加至本機電腦上的PowerShell進程。
第一個命令會使用 Get-Process Cmdlet 來取得電腦上的 PowerShell 進程。 它會將產生的進程物件儲存在名為 $P的變數中。
第二個命令會使用 Cmdlet 的 Debug-Process 參數，在 $P 變數中提交進程物件。
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-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。
輸入
Int32
您可以使用管線將程序標識碼傳送至此 cmdlet。
Process
您可以將進程物件透過管線傳送至此 Cmdlet。
String
您可以使用管線將行程名稱傳送至此 cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 使用 Windows Management Instrumentation （WMI） Win32_Process 類別的 AttachDebugger 方法。 如需此方法的詳細資訊，請參閱 Microsoft Learn 中的 AttachDebugger 方法。
